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Siemens Aktiengesellschaft 


Vorwort 


Dieses Benutzerhandbuch wendet sich an Programmierer, die in ihren Programmen DCAM 
(Data Communication Access Method)-Makroaufrufe verwenden. Sie sollten, wie in Kapitel 1 
erklärt, vorher mit der Beschreibung DCAM-Programmschnittstellen vertraut sein, das 
BS2000 von der Praxis her kennen und den BS2000-Assembler beherrschen. In Kapitel 2 
werden die besonderen Techniken bei der Verwendung der DCAM-Makroaufrufe erklärt. 
Kapitel 3 beschreibt die Makroaufrufe nach ihren Funktionen. Kapitel 4 enthält den Katalog 
aller Aufrufe. Die Anhänge enthalten die Steuerblockfelder, Fehlercodes, Registerbelegung, 
Partnercharakteristika, Erklärung der mnemotechnischen Werte, Formate der Makroaufrufe, 
ferner die Feldnamen für Rückmeldungen, die Kommandos für die Namen-Zuweisung, 
Mnotes sowie die Funktionstastencodes und den Makroaufruf VTCSET. 


Das vorliegende Manual ist Teil der Gesamtbeschreibung der Kommunikations-Zugriffsme- 
thode DCAM, Version 8.0. Thematisch zugeordnet sind ihm Informationsschriften über 
Rechnernetze, Datenfernverarbeitung mit BS2000, eine Kurzbeschreibung von TRANSDATA 
ОСМ und die Beschreibung 'DCAM-Programmschnittstellen’. Für Generierung und Admini- 
stration steht ein eigenes Manual zur Verfügung; zur Programmierung der Kommunikations- 
rechner und der Datenstationen ebenfalls. 


Die Neuerungen gegenüber dem Vorgängermanual (V7.0) sind auf dem Änderungsprotokoll 1 
zusammengefaßt. 


Literaturhinweise werden im Text in Kurztiteln angegeben. Der vollständige Titel jeder 
Druckschrift, auf die verwiesen wird, ist im Literaturverzeichnis aufgeführt. Daran anschlie- 
ßend finden Sie Hinweise zur Bestellung von Druckschriften. 


Bitte unterstützen Sie uns, dieses Manual zu verbessern. Für Ihre Anregungen verwenden Sie 
bitte das rosa Formblatt am Ende des Manuals. 
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Änderungsprotokoll 1 


Änderungen des Vorgänger-Manuals, 
Stand Oktober 1982 (DCAM V7.0), 
durch die Neuausgabe vom 


‚Januar 1985 (DCAM V8.0) 
Seite Änderung 
3-3 Beim Eröffnen einer DCAM-Anwendung durch einen 


3-4#, 4-9, А1-1, А6-1 


3-22f, 4-13, 4-22, А1-2, 


А6-2 


3-23f, 4-13, 4-18а, А1-2, 


А6-2 


3-23f, 4-13,4-18а, А1-2, 


А6-2 


3-23f, 4-13, 4-18, А1-2, 


А6-2 


3-26 


3-26f, 4-51 


3-27 


3-30f, 4-52 


4-7 


4-13, 4-22, А1-2 


4-36 
4-47, 4-55 


4-53f 
4-56 


4-61 
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BATCH-Prozeß wird das Scheduling-Attribut vorüberge- 
hend geändert. | 


Beim Eröffnen einer DCAM-Anwendung muß DCAMVER | 
angegeben werden, falls bestimmte neue Funktionen der 
Version eingesetzt werden sollen. 


Der Nachrichtentransport kann überwacht werden 
(SIGNAL); bei Uberlastung der Verbindung Information des 
Benutzers (Wait for G0 / Go-Signal) 


Ausgabedaten können durch Steuerzeichen ge- 
schützt werden (EXTEND) 


Keine Auswertung der logischen Steuerzeichen 
einer Nachricht (NLOGC) 


Anforderung logischer Quittungen von der Drucker- 
station (LACK) 


Die Einschränkung bei YOPNCON, daß Verbindungsnach- 
richten einem TRANSDATA 960-Rechner nicht zugestellt 
werden, entfällt. 


Zusätzlicher Bereich AAREA im RPB für Verbindungsnach- 
richt des Kommunikationspartners 


DCAM gibt Länge der empfangenen Verbindungsnachricht 
in ARECLN an. 


Bei Annahme einer Aufforderung kann in AREA eine Verbin- 
dungsnachricht für den Partner bereitgestellt werden. 


Bei LINKMOD = PERM muß ein Feld für den Anwendungs- 
namen angegegeben werden. 


Angabe der maximalen Länge der zu sendenden Daten 
(MAXLN) für Optimierung der Systempuffer. 


Neue Mindestlängen für ACB, ССВ, RPB. 


Bei blockweiser Übertragung von Eingabedaten wird CA- 
Option des YRECEIVE vorübergehend unwirksam. 


EID-Ereignis kann auch ein Go-Signal sein. 


Expreßnachrichten sollen nur in Ausnahmefällen gesendet 
werden. 


Die Genauigkeit der Überwachung eines Makroaufrufs in 
der Warteschlange liegt im Sekundenbereich. 


4-63 
4-65 
4-68, А6-6 


A2-3ff 
АЗ-3 


А8-2 
А12-11 
А13-2 
А14-1Н 


Neue Angaben bei Beschreibung von YSEND: EID und 
EIDREF. 


Jeder Fehler beim Senden von Daten beendet den YSEN- 
DREC-Aufruf. 


Der Operand RPB=addr im YSHOWCB-Makroaufruf ist 
überflüssig. 


Zusätzliche und veränderte Rückmeldungen. 


Neue Gründe für LOSCON: Erweiterte Inhaltstabelle für 
Register 6. 


Andere Operanden für CONNECTION-Kommando. 
Gründe für negative Transportquittungen 
Neue logische Anzeigesteuerzeichen. 


Beschreibung DCAM System Exit. 


ОСАМ М8.0А ОСАМ Makroaufrufe, U987-J-Z75-2 


е 


ШШШ 


8 


| | 


An 


Systemkonventionen 


Datensichtstationen 
9749,9750,9752 
Schnittstelle fü 


Programmierer 


ШШШ 


Jobvariablen 


Ц |! 


ШШШ 


File Transfer 
in offenen Rechnernetzen 


Benutzerhandbuch 


BS2000 


Makroaufrufe an den Ablaufteil LEASY RFA 
Beschreibung Beschreibung Beschreibung 
Dienstprogramme 

Beschreibung 

EDOR . SORT PERCON 
Beschreibung Beschreibung Beschreibung 
Dialog-Testhilfe 

Beschreibung 


Anschluß an 
Datenpaket- 
Vermittlungsnetze (X 25, Х.29) 


Beschreibung 


UTM-RPC1 


Benutzerhandbuch 


IFG für FHS 


U 


TRANSDATA 


UTM für RPG-Anwender 


APL-Interpreter APL-Interpreter APL-Interpreter 


Assembler COLUMBUS-ASS 
Beschreibung Benutzerhandbuch 
- PASCAL PASCAL 
Benutzerhandbuch Benutzerhandbuch 
Teil Sprachbeschreibung Тей2 Bedienungsanleitung 
РІЛ РІЛ pi 
PL/I-Compiler PL/I-Compiler PL/I-Compiler 
Beschreibung Benutzerhandbuch Taschenbuch 
Berichtegenerator мон 
Benutzerhandbuch Benutzerhandbuch Datenbankverwaltung 
UDS 
Entwerfen und Definieren PRISMA 
Systembedienung 
| ш | 
SESAM-KLDS А PRISMA 
Assembler- 
Benutzerhandbuch А, я: 
UDS 
UDS-KDBS 
Bedienungsanleitung 
UDS CHECK 
Konsistenzprüf- 
programm 
Benutzerhandbuch 
UDS ' 
Taschenbuch 
* in Vorberei 
UDS 
Meldungen 


Stand 1.85 


TOM-GEN 


Benutzerhandbuch 


Benutzerhandbuch 


GOLEM 
Teil! Datenbankdienste 


Programmiersysteme 


DORA 
Benutzerhandbuch 
RPC1 АРС 
RPG2-Compiler RPG2-Compiler 
Beschreibung Benutzerhandbuch 
СОВ! ; СОВ1 
COBOL-Compiler COBOL-Compiler 
Beschreibung Benutzerhandbuch 
GOLEM PASSAT 
Datenbankdienste TexterschlieBungssystem 
Tabellenheft Beschreibung 


Datenbanksysteme 


ЕРСІ 
RPG2-Compiler 


Anweisungstormate 


LEASY 
LEASY-RPC1 


Beschreibung 


COLUMBUS-COBOL 
Benutzerhandbuch 


SESAM 
Datenbank- 
verwaltung Teil! 


Benutzerhandbuch 


SESAM-LINK 
Beschreibung 


SESAM 
SEKOM 


Beschreibung 


programmierung 
Benutzerhandbuch 


SESAM-DRIVE 


Beschreibung 


SESAM-DRIVE 
Taschenbuch 


SESAM 


Taschenbuch 


rsysteme 


Performance 
Handbuch 


Bedienungsanleitung BS2000 


nerierung 
es 
tenkommunikationssystems 


nutzerhandbuch 
Benutzerhandbuch 


IFG für BERMUDA 
Benutzerhandbuch 


“Т [Ts ПЕ Fr) ER 
S 2 š 
| 1, Gs 
3 j 


Benutzerhandbuch 

TRANSIT-SNA TRANSIT-SSU 
Beschreibung Beschreibung 
TRANSIT-CD 

Beschreibung 


Игтепедотегі Netzmanagement 
eldungen. Programmschnittstelle 
iltkennungen 

Benutz h 
nutzerhandbuch SES 


Struktur der Manuale für 


- BS2000 
- TRANSDATA 
- Programmiersysteme 
- Datenbanken 
Taschenbuch 
Systemanwendung 
Taschenbuch 
Rechenzentrum 
Schnittstellen zur 
DVS Datenkommunikation DPS-9770 
Benutzerhandbuch Benutzerhandbuch Beschreibung 
APSYS9600 Шы ды 
Benutzerhandbuch N ۴ 
BERMUDA DS1 
Benutzerhandbuch Benutzerhandbuch 
TRANSIT-3270LU TRANSIT-RIELU TRANSIT-PRINTLU TRANSIT-BSC 
Benutzerhandbuch Benutzerhandbuch Benutzerhandbuch Beschreibung 


* in Vorbereitung Stand 1.85 


--.. --. — — لے لف‎ --А --А --А — 
лр о N ә 


Inhalt 


Einführung in die Benutzung des DCAM-Benutzerhandbuchs 


Eigenschaften der DCAM-Assembler-Schnittstelle 
Erzeugen von Steuerblöcken . 

Erzeugen von Steuerblöcken während der Assemblierung. 
Erzeugen von Steuerblöcken während des Programmablaufs 
Erzeugen von Steuerblöcken durch den Benutzer 
Bedingungen für Kompatibilität 


Verwendung der Steuerblöcke bei der Ausführung von Aufrufen x 


Verwendung der Kennzeichen 


‚Verändern der Inhalte von Stsunrhlackfaldern . 


Änderungen bei Verwendung des Steuerblocks 
Änderungen mit einem eigenen Aufruf 
Lesen und Sicherstellen von Steuerblockfeldern 
Abfragen und Testen von Steuerblockfeldern . 
Ausführung der Befehle an DCAM 

Synchrone Ausführung 

Asynchrone Ausführung 

Asynchrone DCAM- Meldungen 

LOGON . , 

LOSCON 

PROCON 

COMEND 

EXPR 

ТАСК . 

SECOND 


Anwendung der Funktionen von ОСАМ 


Auf die Existenz einer DCAM-Anwendung bezogene Makroaufrufe 


Eröffnen einer DCAM-Anwendung 
Einfach benutzbare DCAM-Anwendung . 


Erstmaliges Eröffnen einer mehrfach benutzbaren DCAM- Anwendung 


Erstmaliges Eröffnen - Verwendung von Verteilcodes 
Nachfolgendes Eröffnen \ 
Nachfolgendes Eröffnen - Verwendung vi von Verteilcodes 
Verändern des Zustands einer DCAM-Anwendung 
Abfragen des Zustands einer DCAM- SSC 
Schließen einer DCAM-Anwendung 

Auf eine Verbindung bezogene Makroaufrufe ; 

Aufbau einer logischen Verbindung s 

Beschreibung der aufzubauenden Verbindung 

Auffordern zum Aufbau an, 

Annahme einer Aufforderung š š 
Aufbau einer Verbindung - Verwendung v von  Verteilcodes 
Anschließen an eine vordefinierte Verbindung i 
Abfragen der Einträge über Partner und Verbindungen 
Partnerinformation nach einer LOGON-Meldung 
Partnerinformation vor dem Verbindungsaufbau . 
Partnercharakteristika . i 
Partneranzahl , 

Kennzeichen der Verbindung (CID) 

Partner- und Prozessornamen 


DCAM V8.0A DCAM Makroaufrufe, U987-J-Z75-2 


NNNNNNN N N N N 


NNNNNN N N N 


бо со ww Gi د‎ 


w со о 


оо осо ww оо со со со со со 02 


(о сә 


! ! ! ! ! 
оомо > O O OO < O OQ! ООО O + Los 


кә кә кә 
© © 9 


ьОофофомюмюм a ch hb ch فت‎ 


OOO + O O N — ОО < O1 IS O @ O — Ç یں‎ =| 


I 
> 


I 
SE 


т 
> 
со 


Zurückweisen einer Aufforderung zum Verbindungsaufbau 
Ändern der Eigenschaften einer Verbindung 

Rücknahme einer Aufforderung 

Abbau einer Verbindung ; 

Auf die Datenübermittlung bezogene Makroaufrufe 
Senden einer Nachricht ; 

Empfangen einer Nachricht oder Transportquittung ` 
Senden und Empfangen kombiniert 


Zurücknehmen von Empfangsaufrufen und Ändern des CS/CA- Zustands 


Steuerung der Verteilcode-Zuordnung 

Zuordnen eines Verteilungsnamens zu einem 
Verteilcode-Gruppenblock 

Auflösen der Zuordnung 
Auf die Namen-Zuweisung bezogene Makroaufrufe 
Zuweisung für die DCAM-Anwendung 

Zuweisung für die logische Verbindung 


Katalog der Makroaufrufe . 


ҮССВ . 
ҮСНАМСЕ . 
YCLOSE 
YCLSCON 
YCONN . 
YDCG 
YDIP . 
YENO, 
YFORBID 
ҮСЕМСВ . 
YINQUIRE . 
YMODCB 
ҮОРЕМ i 
YOPNCON . 
YPERMIT . 
YRECEIVE . 
YREJLOG 
YRESET 
YRPB 
ҮӘЕМО. eg 
YSENDREC 
YSETLOG . 
YSHOWCB 
YTESTCB 


Anhang . . . 

Tabelle der Steuerblockfelder 

Tabelle der Rückmeldungen . 

Registerbelegung 

Partnercharakteristika . 

Mnemotechnische Werte der Makroaufrufe 

Formate der Makroaufrufe (DCAM) 

Kontrollblöcke und Rückmeldungen: Namen für Felder und Werte 
Kommandos für die Namen-Zuweisung . 

Mnotes . 

Verschlüsselung des Funktionstastencodes | 
Auswirkungen der CCITT-Empfehlung X.25auf die 
IDCAM-Benutzerschnittstelle 
Gründe für negative Transportquittu ngen 
Logische Steuerzeichen für den Line-Mode (VTCSET) 


DCAM М8.0А ОСАМ Makroaufrufe, U987-J-Z75-2 


А.14 
A.14.1 
A.14.2 
A.14.2.1 
A.14.2.1.1 
A.14.2.1.2 
A.14.2.1.3 
A.14.2.2 
A.14.2.2.1 
A.14.2.2.2 
А.14.2.3 
А.14.2.4 


Literatur 
Bestellung 
Stichwörter 


Beschreibung DCAM System Exit . 
System Exits Bedienung š 
System Exits Programmschnittstelle | 
DCAM Exit Programmschnittstelle 
Registerversorgung 

DCAM-Exit- Parameterliste 
Rückkehrinformation 
DCAM-Exit-Ereignisse 

DCAM Datenstruktur 
Rückinformation für die Exit- Ereignisse 
Einschränkungen für DCAM-Exit-Routinen . 


DSECT-Makroaufrufe für die DCAM-Kontrollblöcke ` 


DCAM М8.0А DCAM Makroaufrufe, U987-J-Z75-2 


Bilder- und Tabellenverzeichnis 


Bild 


— ` sch کے‎ 
о БА 


NNNNN N 
© OT P G N د‎ 


NNNNNN N N N N 


Tabelle 
2-1 


4-1 


Aufbau der Beschreibung und des Benutzerhandbuchs 
Benutzung der Manuale für Anfànger 
Benutzung der Manuale für Geübte 


DCAM-Assembler-Schnittstelle 

Makroaufrufe und Steuerblócke ; 
Makroaufrufe zum Erzeugen von Steuerblócken ; 

Beispiel für statische Steuerblockerzeugung 

Verwendung des MF-Operands bei YGENCB 

Beispiel für Änderung bei der dynamischen Erzeugung des 
Steuerblocks . EA иу. 
Beispiel für dynamische Steuerblockerzeugung 
Verwendung der Kennzeichen 

Beispiel für Änderung bei Verwendung eines 5 Steuerblocks 


Beispiel für Änderung von Steuerblockfeldern mit YMODCB 


Beispiel für Sicherstellung von Steuerblockfeldern 
Beispiel für Prüfung eines Steuerblockfelds 
Angaben bei synchroner Ausführung des SOLSIG 
Angaben bei asynchroner Ausführung des SOLSIG . 
Übergabe der Ereignis-Information 
Angaben bei Definition einer Contingency für 
DCAM-Ereignismeldungen . 

Beispiel für Anwendung der LOGON- Contingency 


‚Erklärung der grafischen Darstellung 


Kennzeichen 


Makroaufrufe 


DCAM М8.0А DCAM Makroaufrufe, U987-J-Z75-2 


== miii ын 


NPNNNN N N N 


N N N N N 
чм отл ы 


кә ә 


о м د‎ со zl OO +. (O © 


Einführung in die Benutzung des 
DCAM-Benutzerhandbuchs 


Eigenschaften der DCAM-Assembler-Schnittstelle 
Anwendung der Funktionen von DCAM 


Katalog der Makroaufrufe 


:-1-1-1-1- 


Anhang 


1 Einführung in die Benutzung des 
6 DCAM-Benutzerhandbuchs 


Um allen Anwendern, sowohl den Anfängern, als auch den bereits in der DCAM-Assembler- 
Schnittstelle Geübten gerecht zu werden, wurde die Beschreibung in zwei Manuale aufgeteilt 
(siehe Bild 1-1). 


DCAM-Programmschnittstellen DCAM-Makroaufrufe 
Kapitel Kapitel | 


* 


Standort 
Bild 1-1 Aufbau der Einführung und des Programmierhandbuchs 
Wie soll der DCAM-Anfänger vorgehen? 


Er sollte auf jeden Fall mit einem gründlichen Studium der 'DCAM-Programmschnittstellen’ 
beginnen. Erst wenn er dieses Manual durchgearbeitet hat, ist er vorbereitet, um mit dem hier 
vorliegenden Benutzerhandbuch umzugehen. 


© Die Absicht des Verfassers ist auch am Stil und Aufbau der beiden Beschreibungen zu 
erkennen: 'DCAM-Programmschnittstellen’ wurde so geschrieben, daß es 'sequentiell’ zu 
lesen ist. Der Benutzer wird Schritt für Schritt in DCAM eingeführt. Zuerst durch eine 
allgemeine Einführung, die eine Orientierung ermöglicht. Im nächsten Kapitel werden Grund- 
begriffe erläutert und Vorüberlegungen zur Programmplanung angestellt. Kapitel 3 enthält die 
detaillierte Beschreibung aller Funktionen. Codierung und Ausführung von DCAM-Program- 
men wird im 4. Kapitel behandelt. Die bereits in Kapitel 4 enthaltenen Hinweise und 
Übersichten für den Assembler-Programmierer werden nun in dem hier vorliegenden Benut- 
zerhandbuch im Kapitel 2 noch eingehender erörtert. Hat er dieses Kapitel ebenfalls gut 
durchgearbeitet, ist er gerüstet für die praktische Arbeit. Seine folgende Benutzung der 
Manuale wird wohl mehr indiziert sequentiell’ erfolgen. Zu diesem Zweck wurde der Aufbau 
des 3. Kapitels, das die Beschreibung der einzelnen Aufrufe enthält, in beiden Manualen nach 
Funktionen geordnet. Die Einteilung der Abschnitte ist weitgehend gleich. Der Benutzer kann 
von der Detailbeschreibung der Funktion in DCAM-Programmschnittstellen ausgehen und 
findet nun hier die praktische Anwendung. Als zusätzliche Hilfe sind in Kapitel 4 alle 
Makroaufrufe in einem Katalog alphabetisch geordnet. Ferner wurden im Anhang alle 
wichtigen Übersichten und Tabellen zusammengefaßt. Bild 1-2 zeigt den Weg des Anfängers 
durch die Manuale. 
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Der Weg des Anfängers: 
DCAM-Programmschnittstellen DCAM-Makroaufrufe 
START 


Kapitel Kapitel 


Bild 1-2 Benutzung der Manuale für Anfänger 


Wie soll der bereits mit DCAM vertraute Benutzer mit den beiden Beschreibungen arbeiten? 


Ihm kommt das Benutzerhandbuch in seinem Aufbau ebenfalls entgegen. Angenommen, er 
kennt sich soweit aus, daß er nur im Katalog nachschaut (Kapitel 4), kann er von dort aus über 
einen entsprechenden Verweis weitere Informationen aus Kapitel 3, der Funktionsbeschrei- 
bung, holen. Wissenslücken können geschlossen werden durch Rückgriff auf die gleich 
nummerierten Abschnitte in DCAM-Programmschnittstellen. Auf Bild 1-3 wird der Weg des 
Geübten durch die Manuale veranschaulicht. 


Nun bleibt nur noch zu wünschen, daß das erläuterte Konzept des Verfassers zum Erfolg führt. 
Er wird jedenfalls allen, sowohl dem Anfänger, als auch dem Geübten gewünscht. 
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DCAM-Programmschnittstellen DCAM-Makroaufrufe 
© -Kapitel Kapitel 


Bild 1-3 Benutzung der Manuale für Geübte 
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Eigenschaften der DCAM-Assembler-Schnittstelle 


| 


Eine Einführung in die Eigenschaften der Assembler-Schnittstelle wurde bereits in der 
Beschreibung der Programmschnittstellen gegeben. 


Alle Makroaufrufe an DCAM, soweit sie nicht der Steuerblockerzeugung und -behandlung 
selbst dienen, beziehen sich auf Steuerblöcke. Die Form dieser Aktionsaufrufe ist so angelegt, 
daß Steuerblöcke und Befehle (mit Aktionsaufruf) getrennt abgesetzt werden. 


Folgende Schritte sind im Programmablauf notwendig: 


1. Schritt: 


2. Schritt: 


3. Schritt: 


4. Schritt: 


5. Schritt: 


Bereitstellen der Informationen in Steuerblöcken durch Erzeugen dieser 
Steuerblöcke und Eintragen der Inhalte. 


Bei Abgabe eines Aktionsaufrufs an DCAM wird der Steuerblock adres- 
siert, der alle notwendigen Informationen enthält. 


Bei der Bearbeitung des Aufrufs holt sich DCAM die Felder, die benötigt 
werden, aus den angegebenen Steuerblöcken und darin adressierten 
variablen Feldern. DCAM baut sich eine Kopie des Steuerblocks mit den 
aktuellen Werten auf. 


In den Steuerblock des Benutzers trägt DCAM die Rückinformationen 
ein (Rückmeldung, Kennzeichen, usw.) und beendet den Aufruf. 


Der Benutzer wertet die Rückinformationen aus, indem er auf die von 
DCAM ausgefüllten Steuerblockfelder bzw. Registerinhalte zugreift. 


Einen Überblick über die Grundschritte der Verarbeitung gibt Bild 2-1. 
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Ө Bearbeitung des Aufrufs, dazu evtl. Übernahme der aktuellen 


eter aus den Steuerblöcken in eine eigene Kopie 


) Übergabe der Rückinformation 
und Beenden des Aufrufs 


Bild 2-1 DCAM-Assembler-Schnittstelle 


S DCAM М8.0А DCAM Makroaufrufe, U987-J-Z75-2 


23 Erzeugen von Steuerblöcken 


Steuerblöcke sind Bereiche mit vorgegebenem Format, die Operanden für Aktionsaufrufe 
enthalten (siehe dazu Bild 2-2). 


Aktions- Steuerblöcke | 


Makroaufruf Beschreibung des ` Beschreibung der Anwendung, Meldungen, 
ап DCAM ` Makroaufrufs ‚Verbindung, Verteilcodes 


nn der Abkürzungen: 4 

АСВ (application control block) = Anwendungssteuerblock addr ; 

ENB (event notification block) = Ereignis-Meldungsblock relexp ) тө мам АР 
RPB (request parameter block) = Anforderungsparameter-Block 

CCB (connection control block) = Verbindungssteuerblock 

DIP (distribution parameter block) = Verteilungsparameter-Block 

DCG (distribution code group block) = Verteilcodegruppen-Block 


Bild 2-2 Makroaufrufe und Steuerblöcke 
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2.1.1 


Drei Wege der Steuerblockerzeugung stehen zur Auswahl: 
— Statische Erzeugung (zum Zeitpunkt der Assemblierung); 
— Dynamische Erzeugung (während des Programmablaufs); 


— Direkte Erzeugung (statisch, durch den Benutzer). 


In Bild 2-3 werden die Makroaufrufe zur Erzeugung von Steuerblöcken im Überblick gezeigt. 


Makroaufrufe zur statischen Makroaufruf zur dyna- 
Erzeugung mischen Erzeugung 
(während der Assemblie- (während des Programm- 
rung) Steuerblöcke ablaufs) 


Bild 2-3 Makroaufrufe zum Erzeugen von Steuerblöcken 


Erzeugen von Steuerblöcken während der Assemblierung 


Die Steuerblöcke, die während der Assemblierung erzeugt werden sollen, werden im Daten- 
teil des Programms beschrieben. Dazu wird der entsprechende Makroaufruf gegeben, sodaß 
nach der Makroauflösung der Steuerblock an dieser Stelle im Programm steht. 


Die Inhalte der einzelnen Felder werden 


— durch den Benutzer bestimmt, indem er entsprechende Werte mit einem vorgegebe- 
nen Schlüsselwort verbindet. 


— vom Makrogenerator bestimmt, wenn der Benutzer durch Weglassen einzelner 
Schlüsselworte anzeigt, daß er Standardwerte eingetragen haben möchte. (Er kann, 
wenn er will diese Standardwerte auch angeben). 


— zunächst offengelassen für die Eintragungen, die DCAM nach Ausführung eines 
Aktionsaufrufs machen wird. 


Die Eintragungen in den Steuerblock sind entweder selbstdefinierende Werte, die als 'code' 
oder "konstante’ angegeben werden. Oder aber es sind Adreßverweise (’relexp’) auf weitere 
Steuerblöcke oder Felder. Diese Felder enthalten Namen oder sind Bereiche zur Datenüber- 
nahme/-gabe. 


Die Adresse des Makros, der den Steuerblock erzeugt, wird später vom Benutzer verwendet, 
um den Steuerblock zu adressieren (адаг). Er kann diese Adresse auch in einem Register 
übergeben (siehe Anhang А.5). 
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Im Bild 2-4 wird an einem Beispiel das Verfahren im Überblick gezeigt. Es wird еіп ACB und ein 
ENB erzeugt, um eine DCAM-Anwendung eröffnen zu können (siehe dazu auch 3.1.1.3). 


Benutzerprogramm | 
Befehle Konstanten und Variable 


Erzeugung der Steuerblöcke: 


Гг 

{ 

! 
— 


ЕМВ1 ` END LOGON = CO1, u 
EXPR = CO2 


CO1 DS F 5 
002- DB F 3 
) Einträge werden уот Makro- 
aufruf ENACO gemacht 
Bild 2-4 Beispiel für statische Steuerblockerzeugung 
2-5 
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Erzeugen von Steuerblöcken während des Programmablaufs 


Die vorher beschriebene statische Erzeugung der Steuerblöcke hat den Nachteil der Abhän- 
gigkeit vom Format der Steuerblöcke. Da die Steuerblöcke meist Adressen variabler Felder 
enthalten, ist auf diesem Weg auch keine ablaufinvariante (reentrant-) Programmierung 
möglich. 


Die dynamische Steuerblockerzeugung bietet hingegen: 


— Steuerblöcke können im Klasse-5-Speicher eingerichtet werden, d.h., der Benutzer 
braucht sich um den Speicherplatz nicht zu kümmern. Er liegt außerhalb seines 
Programms. 


— Er kann aber statt dessen auch einen Bereich in seinem Programm reservieren und 
sich den Steuerblock an dieser Stelle erzeugen. 


— Die Verweisadressen auf Felder und andere Steuerblöcke können in Registern ange- 
geben werden. 


— Mit einem Aufruf können mehrere Steuerblöcke eines Typs erzeugt werden. 
— Sonstige Feldbeschreibungen entsprechen den Angaben bei statischer Erzeugung. 


Der Aufruf zur dynamischen Erzeugung YGENCB, wie auch die Aufrufe zur Behandlung von 
Steuerblöcken, YMODCB (2.4.2), YSHOWCB (2.5) und YTESTCB (2.6), werden in ihrer Form 
durch den MF-Parameter bestimmt. 


Wird er nicht angegeben, wird die Operandenliste des Aufrufs zusammen mit dem Befehl 
abgesetzt. Dies ist jedoch, insbesondere bei der ablaufinvarianten Programmierung, nicht 
erwünscht. 


Der MF-Operand ermöglicht die getrennte Erzeugung von Operandenliste (Listenform oder 
L-Form des Makroaufrufs) und Befehl (Befehlsform oder E-Form des Makroaufrufs). 
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Bild 2-5 zeigt am Beispiel des YGENCB die Verwendung des MF-Parameters. 


ES 
222 | 


Ansprung mit | Übergabe der 
Adresse der | Parameterliste 
(hier in | Register 3) 


Übernehmen der 
Parameterliste 


Bild 2-5 Verwendung des MF-Parameters bei YGENCB 
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Die Listenform (МЕ = L) wird im Konstanten- oder Variablen-Teil des Programms abgesetzt. 
Der Makroaufruf wird mit einem Namen versehen, damit die Operandenliste adressiert 
werden kann. Aus den angegebenen Operanden wird eine Operandenliste erzeugt (Konstan- 
ten, Adreßkonstanten, usw.). 


Die Befehlsform (MF = (Е,адаг)) wird im Befehlsteil des Programms abgesetzt. Sie erzeugt 


— eine Befehlsfolge, die den SVC (supervisor call) an DCAM enthält und den Bezug zur 
Operandenliste, deren Adresse in ‘addr’ angegeben wird. Die Adresse der Operandenliste 
kann auch in einem Register angegeben werden (Register 2-15). Das Register 1 darf dazu 
nicht verwendet werden. 


— wahlweise eine Parameterliste, die Werte der adressierten Operandenliste ergänzt oder 
aktualisiert. Dieses Verfahren ist eigens für DCAM eingeführt worden, um Operandenli- 
sten universell einsetzen zu können. Die Steuerblöcke werden erzeugt mit den Operanden 
der gesonderten Liste und den neuen Werten, die hier angegeben wurden (siehe Bild 2-6). 


Erzeugen eines 
Steuerblocks ACB 


Bild 2-6 Beispiel für Änderung bei der dynamischen Erzeugung des Steuerblocks 
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Im Bild 2-7 wird an einem Beispiel gezeigt, wie der Aufruf ҮСЕМСВ eingesetzt werden kann. Es 
werden Steuerblöcke im Klasse-5-Speicherbereich (von DCAM verwaltet) erzeugt. Die Adres- 
sierung erfolgt ausschließlich über Register (um diese Möglichkeit zu zeigen). Es wird der 
MF-Operand verwendet. Damit wird die gleiche Programmaufteilung wie in Bild 2-4 erreicht. 
Es wird damit ferner die Verwendung bei ablaufinvarianter Programmierung gezeigt. 


In diesem Beispiel wird ein ENB und ein ACB dynamisch erzeugt, um eine DCAM-Anwendung 
eröffnen zu können (siehe dazu auch 3.1.1.3). 


Benutzerprogramm 


Befehle | Konstanten und Variable 


Erzeugung der Steuerblöcke: | Parameterlisten: 


') Einträge werden von 
Makroaufruf ENACO 
gemacht 


Bild 2-7 Beispiel für dynamische Steuerblockerzeugung 
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2.1.3 Erzeugen уоп Steuerblöcken durch den Benutzer 


Mit Hilfe der Makros 


YDDACB 
YDDCCB 
YDDDCG 
YDDDIP 

YDDENB 
YDDRPB 


kann der Benutzer Steuerblöcke direkt erzeugen und manipulieren (statt mit YGENCB, 
YMODCB, etc). Diese Makros beschreiben das Format der Steuerblöcke (DSECT bzw. 
CSECT). Sie sind im Anhang A.7 ausführlich beschrieben. 


2.1.4 Bedingungen für Kompatibilität 


1. Objekt-Kompatibilität 
— Beim Makro YGENCB darf der WAREA-Operand nicht gesetzt werden. 


— Die Steuerblöcke müssen mit den Makros YMODCB, YSHOWCB und YTESTCB 
manipuliert werden. 


Wenn diese Bedingungen beachtet werden, ist keine Neuübersetzung nötig. 
Hinweis: 


Wenn beim WAREA-Operanden (Makro YGENCB) der LENGTH-Operand zu klein angege- 
ben wird, muß das Programm geändert und neu übersetzt werden. 


2. Source-Kompatibilität 
Die Steuerblöcke 
— müssen statisch erzeugt (YACB, YCCB, usw.) 
— und mit manipulativen Makros (YMODCB usw.) behandelt werden. 


Wenn diese Bedingungen beachtet werden, muß das Programm nicht geändert und 
möglicherweise nicht neu übersetzt werden. 


Hinweis: 


Wenn die Steuerblöcke mit den neuen Makros YDDACB, YDDCCB, usw. erzeugt und 
manipuliert werden, ist keine Kompatibilität gewährleistet, da sich bei Neuentwicklungen 
das Format der Steuerblöcke ändern kann. Hierbei müßte das Programm geändert und 
neu übersetzt werden. 
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2.2 | Verwendung der Steuerblöcke bei der Ausführung von Aufrufen 


Nachdem ein Steuerblock erzeugt wurde, kann er zur Ausführung eines Aktionsmakros 
verwendet werden. Zu diesem Zweck muß er alle Eintragungen enthalten, die zur Ausführung 
des Aufrufs notwendig sind. In Kapitel 3 werden alle Aufrufe mit den entsprechenden 
Operanden gezeigt. Es kann ein Steuerblock Eintragungen enthalten, die sich nicht auf den 
aktuellen Aktionsmakro beziehen, jedoch werden nur die ausgewertet, die für den entspre- 
chenden Aufruf gebraucht werden. 


Bis zur Beendigung des Aufrufs (synchrone Ausführung, 2.7.1) bzw. bis zur Beendigung des 
Befehls (asynchrone Ausführung, 2.7.2) wird ein RPB oder CCB als belegt gekennzeichnet. 


Die Anzeige steht im FLAG-Feld des Steuerblocks (siehe Anhang А.1): 
FLAG=ACTIVE: Der Steuerblock wird gerade verwendet (ist belegt). 
FLAG=INACTIVE: Er wird gerade nicht verwendet (ist frei). 


Danach hat der Benutzer die Möglichkeit, die Felder des Steuerblocks auszuwerten, die von 
DCAM gesetzt wurden. Dies sind insbesondere das Rückmeldefeld und das Kennzeichen. 
Weitere Felder sind je nach Aufruf im RPB oder CCB gesetzt (siehe dazu die einzelnen 
Funktionen in Kapitel 3). 


© Ein Steuerblock ist für mehrere Aufrufe verwendbar. Die einzelnen Felder müssen allerdings 
mit den aktuellen Werten versorgt sein. 


Hinweis: 


Der YOPNCON (Aufbau einer Verbindung; 3.2.1.2. und 3.2.1.3) zerstört im RPB die Verweis- 
adresse zum verwendeten CCB. Dadurch soll der Versuch, eine Verbindung irrtümlicherweise 
zweimal aufzubauen, verhindert werden. 
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2.3 Verwendung der Kennzeichen 


An einem typischen Ablauf wird in Bild 2-8 gezeigt, wie die Kennzeichen eingesetzt werden 


können. 


Das zurückgegebene Kennzeichen erlaubt es dem Benutzer, sich auf die an DCAM übergebe- 
nen Steuerblockinhalte zu beziehen. Dies betrifft die Steuerblöcke, die eine Anwendung oder 
eine Verbindung beschreiben, und fernerhin die Steuerblöcke, die Verteilcodeparameter und 
Verteilcodes enthalten. Wird eine DCAM-Anwendung eröffnet oder eine Verbindung aufge- 
baut, so enthalten die Steuerblöcke, die dazu verwendet werden, nach Ausführung des 
entsprechenden Aufrufs das gültige Kennzeichen (siehe Tabelle 2-1). 


Name | erzeugt mit 


YOPNCON 


ҮОРНС 
oder 
YPERMIT 


*) Mit YMODCB oder mit einem Aktionsaufruf 


Tabelle 2-1 


von DCAM zurück- 
gegeben in: 


CID-Feld des 
CCB-Steuerblocks 
und CID-Feld des 


RPB-Steuerblocks, 


der beim Aufruf 
YOPNCON benutzt 
wird. 


GID-Feld des 


DCG-Steuerblocks. 


Kennzeichen 


kann vom Benutzer 
eingetragen werden 
ж 


un: 


` CID-Feld des 


RPB-Steuerblocks 


GID-Feld des 
DCG-Steurblocks. 


ungültig nach: 


YCLSCON oder 
erzwungenem 
Abbruch der 
Verbindung 
(forced 
disconnection) 


YCLSCON oder 
erzwungenem 
Abbruch der 
Verbindung 
(forced 
disconnection) 
oder YFORBID 
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Der Benutzer hat zwei Möglichkeiten: 


— Entweder er adressiert für künftige Aufrufe den entsprechenden Steuerblock ACB, 
CCB, DIP und DCG, der jeweils das gültige Kennzeichen enthält oder 


— erstellt die zurückgegebenen Kennzeichen in eigenen Feldern sicher. Die Steuerblöcke 
kann er nun wieder verwenden oder die Bereiche freigeben. 


Will er sich auf die mit den Kennzeichen erreichbaren Einträge in DCAM beziehen, muß 
er die Kennzeichen der Anwendung (AID) und der Verbindung (CID) in den verwen- 
deten RPB eintragen. 


Hinweis: 


Nach einem YOPNCON (Aufbau einer Verbindung) oder einem YRECEIVE (Empfangen 
einer Nachricht) ist das Kennzeichen der Verbindung (CID) auch im RPB eingetragen. 
Ein direkt darauf folgender YSEND (Senden einer Nachricht), YRECEIVE oder YSEN- 
DREC kann sich auf diese Verbindung beziehen, ohne vorher das Kennzeichen 
eintragen zu müssen. 


Die Eintragung in den RPB ist auf zweifache Weise möglich (siehe den folgenden Abschnitt). 
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Bild2-8 Bitte herausklappen ` ` 


C 


2.4 Verändern der Inhalte von Steuerblockfeldern 


Soll derselbe Steuerblock von verschiedenen Aufrufen als Operandenfeld benutzt werden, so 
muß er jeweils mit den aktuellen, für den Aufruf gültigen Werten versorgt werden. Um dies zu 
erreichen und um überhaupt Änderungen in einem Steuerblock zu machen, gibt es zwei 
verschiedene Möglichkeiten. 


2.4.1 Änderungen bei Verwendung des Steuerblocks 


An einem Beispiel wird dieses Verfahren in Bild 2-9 gezeigt. 


vor Ausführung von YOPNCON 


RPBI ҮНРВ ОРТСО = ACQUIRE 


nach Ausführung von YOPNCON 


Bild 2-9 Beispiel für Änderung bei Verwendung eines Steuerblocks 


Das Ändern von Feldinhalten bei Verwendung des Steuerblocks ist nur beim АРВ möglich; 
notwendigerweise dann, wenn ein RPB für mehrere unterschiedliche Aufrufe verwendet wird. 
Die Feldinhalte, die geändert werden sollen, können im Makroaufruf mit der Adresse des zu 
ändernden RPB angegeben werden. Dadurch werden die alten Eintragungen im Steuerblock 
überschrieben. Die ursprünglichen, bei der Steuerblockerzeugung angegebenen Werte, sind 
nicht mehr erreichbar. Im Gegensatz zur statischen Erzeugung können Adressen bei dieser 
Änderung wie auch bei der dynamischen Erzeugung in einem Register angegeben werden. 


S Im Katalog der Makroaufrufe (Kapitel 4) sind bei allen Aktionsaufrufen die Felder aufgeführt, 
die jeweils benötigt werden. Sie können mit dem Aufruf in der angegebenen Weise neu 
gesetzt werden. Darüber hinaus können alle beliebigen Felder des RPB, soweit für den 

Benutzer veränderbar, gesetzt werden (siehe dazu Anhang А.1). 


Zu beachten ist, daß hierbei nicht auf Standardwerte zurückgegriffen werden kann, wie dies 
in Kapitel 3 gezeigt wird. Dort wird zur Erleichterung der Arbeit immer ein eigens für den 
Aktionsaufruf generierter Steuerblock benutzt, sodaß Standardwerte nicht angegeben wer- 
den müssen. Dies erbringt auch eine geringere Laufzeit. 
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2.4.2 Апаегипдеп тїї еїпет eigenen Aufruf 


Der Illustration dient das Bild 2-10 und auch das Bild 2-8 im Abschnitt über die Verwendung 
der Kennzeichen (siehe 2.3). 


Benutzerprogramm 
Befehle | Konstanten und Variable 
Veranlassung der Änderung: Parameterliste der Änderungen: 


zu ändernder Steuerblock: 


*) Kennzeichen wurde nach 
YOPEN sichergestellt. 

**) Kennzeichen wurde nach 

YOPNCON sichergestellt. 


Bild 2-10 Beispiel für Änderung von Steuerblockfeldern mit YMODCB 


Zum Ändern der Inhalte eines oder mehrerer Felder eines Steuerblocks kann der Aufruf 
YMODCB verwendet werden. Er hat speziell diese Funktion. Welche Felder geändert werden 
können, ist der Tabelle im Anhang A.1 zu entnehmen. 


Beachtet werden muß, daß ein Steuerblock nur geändert werden kann, wenn er nicht gerade 
zur Ausführung eines Befehls (FLAG= ACTIVE) verwendet wird (vgl. 2.2). Zur Unterstützung 


der ablaufinvarianten Programmierung ist der MF-Operand (siehe 2.1.2) verwendbar. Die 
Operandenliste der Änderungen kann damit vom Aufruf getrennt im Programm definiert ә 
werden. 
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2.5 Lesen und Sicherstellen von Steuerblockfeldern 


Der Illustration dient das Bild 2-11. 


Benutzerprogramm 


Befehle Konstanten und Variable 


Veranlassung der Übertragung: Parameterliste der Übertragung: 


Bild 2-11 Beispiel für Sicherstellung von Steuerblockfeldern 


Sollen aus einem Steuerblock einzelne Felder gelesen und in eigene Speicherbereiche 
übertragen werden, muß der Aufruf YSHOWCB benutzt werden. So ist es z.B. möglich, die 
von DCAM zurückgegebenen Kennzeichen sicherzustellen (siehe Bild 2-8). Um die einzelnen 
Felder anzusprechen, gibt es für jedes Feld ein Schlüsselwort (siehe dazu die Tabelle im 
Anhang A.1) und eine festgelegte Länge. 


Zur Unterstützung der ablaufinvarianten Programmierung ist der MF-Operand (siehe 2.1.2) 
verwendbar. Die Operandenliste der zu lesenden Felder kann damit vom Aufruf getrennt im 
Programm definiert werden. 
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2.6 


Veranlassung der Feldprüfung: Рагатеїегііѕїе der Feldprüfung: 


Abfragen und Testen von Steuerblockfeldern 


Um einzelne Steuerblockfelder auf ihren Inhalt prüfen zu können, ohne diese Felder in einen 
eigenen Speicherbereich übertragen zu müssen, gibt es den Aufruf YTESTCB. Es können 
dazu die Schlüsselworte und Testwerte verwendet werden, die in der Tabelle der Steuerblock- 
felder im Anhang A.1 aufgeführt sind. 


Zur Unterstützung der ablaufinvarianten Programmierung ist der MF-Parameter (siehe 2.1.2) 
verwendbar. Die Operandenliste kann somit getrennt vom Aufruf zur Ausführung im Pro- 
gramm definiert werden. 


In Bild 2-12 wird an einem Beispiel die Verwendung gezeigt: Es wird in einem Steuerblock das 
Feld überprüft, welches anzeigt, ob dieser Block gerade für eine Befehlsausführung gebraucht 
wird. 


Benutzerprogramm 


Befehle | Konstanten und Variable 


Steuerblock, dessen Feld geprüft wird: 


Bild 2-12 Beispiel für Prüfung eines Steuerblockfeldes 
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2.7 Ausführung der Befehle ап DCAM 


Zwei Wege stehen dem Benutzer zur Ausführung der Befehle an DCAM offen: 


— Synchrone Ausführung: Einfache Handhabung, wenig Angaben; dafür keine optimale 
Ausnutzung von Wartezeiten 


— Asynchrone Ausführung: Optimale Ausnutzung der Wartezeiten; dafür mehr Auf- 
wand im Programm (nur bei YOPNCON, YRECEIVE und YSENDREC). 


Zur Registerbelegung bei der Ausführung siehe die Tabellen im Anhang А.З. 


2.7.1 Synchrone Ausführung 


Bei der synchronen Ausführung (Operand OPTCD=SYN) erhält das Programm die Steuerung 
erst zurück, wenn der Befehl ausgeführt ist. 


Was geschieht aber, wenn der Aufruf nicht sofort befriedigt werden kann, z.B. bei YOPNCON, 

YRECEIVE oder YSENDREC? In diesem Fall kann man auswählen zwischen der Möglichkeit, 

auf das Eintreffen des Ereignisses zu warten (z.B. Eintreffen der Nachricht) oder aber die 
© Steuerung mit dem entsprechenden Hinweis sofort zurück erhalten: | 


— OPTCD=Q L(OPTCD = option command; О = queue) 


Der Aufruf wird in eine Warteschlange eingetragen, bis das erwartete Ereignis eintritt. 
Dafür kann mit TOVAL=n eine maximale Wartezeit festgelegt werden (TOVAL = ti- 
meout value). Der Aufruf wird beendet, d.h. der Benutzer erhält die Steuerung zurück, 
wenn das Ereignis eingetreten ist oder die Wartezeit abgelaufen ist. 


- ОРТСО = МО 


Der Aufruf wird sofort beendet, auch dann, wenn das erwartete Ereignis nicht 
eingetreten ist. Bei einem YOPNCON, OPTCD=ACCEPT (siehe 3.2) kann dies bedeu- 
ten, daß keine Verbindungsaufforderung des Partners vorhanden war. Bei einem 
YRECEIVE bzw. YSENDREC (siehe 3.3) war die Nachricht noch nicht eingetroffen. In 
diesem Fall muß der Benutzer den Aufruf ggf. zu einem anderen Zeitpunkt wiederho- 
len. 


Hinweis: 


Es kann immer nur ein synchroner Aufruf ablaufen, der Wartezeit verursacht (YOPN- 

СОМ ACQUIRE, YOPNCON (АССЕРТ,О) YRECEIVE О, YSENDREC О). 

Ein zweiter synchroner Aufruf mit Wartezeit (aus einem Contingency-Prozeß, gestartet 
© während der Wartezeit) wird abgelehnt. 
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2.7.2 Asynchrone Ausführung 


Befehle, mit denen auf das Eintreffen eines Ereignisses möglicherweise gewartet werden 
muß, können auch asynchron ausgeführt werden. Dies bedeutet, daß der 
Parameter ОРТСО = ASY angegeben werden muß. Die Angabe ist nur möglich bei 


— YOPNCON (siehe 3.2) und 
— ҮНЕСЕІМЕ bzw. YSENDREC (siehe 3.3). 


Zur asynchronen Ausführung arbeitet DCAM mit der Р1 Eventing/Contingency-Schnittstelle 


zusammen. 


Folgende Schritte sind für den Benutzer notwendig: 


1. Schritt: 


2. Schritt: 


3. Schritt: 


4. Schritt: 


Für jeden asynchronen Aufruf muß ein Ereigniskennzeichen 

(EID = event item identifier) verwendet werden. Zur Definition ist der 
Aufruf ENAEI (enable event item) zu verwenden. Das Kennzeichen wird 
vom System benutzt,um das Eintreffen des Ereignisses zu verbuchen. 


Soll bei Eintreffen eines Ereignisses eine Unterbrechungsroutine 
(Contingency) gestartet werden (asynchroner SOLSIG, siehe 4. Schritt), 
muß sie definiert werden. Der Aufruf ENACO (enable contingency) legt 
die Routine und ihre Anfangsadresse fest. Soll eine Contingency nicht 
oder nur unter Berücksichtigung anderer Routinen zum Ablauf kommen, 
kann ihr gezielt eine Priorität von 1 (niedrigste) bis 127 (höchste) 
zugeordnet werden. Diese kann während des Ablaufs geändert werden 
(Makroaufruf LEVCO, siehe Manual 'BS2000 Makroaufrufe an den 
Ablaufteil’). 


Die Routine wird auch angestoßen, wenn die maximale Wartezeit 
abgelaufen oder ein Fehler aufgetreten ist. Wird eine Contingency- 
Routine gestartet, erhält der Benutzer in verschiedenen Registern Infor- 
mationen (siehe dazu die Tabellen der Registerbelegungen in Anhang 
A.3). Alle weiteren Register muß er selbst versorgen (auch die Basisregi- 
ster). Auf Registerinhalte der unterbrochenen Routine oder der Haupt- 
routine kann ег тії dem Makroaufruf CONTXT (siehe Manual 'В52000 
Makroaufrufe an den Ablaufteil’) zugreifen. 


Das Ereigniskennzeichen EID muß angegeben werden, wenn im 
YOPNCON, YRECEIVE oder YSENDREC der Parameter OPTCD=ASY 
gesetzt wird. Dazu wird die Adresse des Feldes angegeben, in den der 
Makroaufruf ENAEI das Kennzeichen hinterlegt hat. Es muß ferner 
definiert werden, daß der Aufruf in eine Warteschlange eingetragen 
werden soll (OPTCD = О) außer bei ҮОРМСОМ, (OPTCD= ACQUIRE), 
ggf. mit einer maximalen Zeitangabe (TOVAL). Der Auftrag bleibt in der 
Warteschlange, bis der Befehl ausgeführt werden kann (z.B. Übergabe 
der Nachricht bei YRECEIVE) oder die maximale Wartezeit abläuft oder 
ein Fehler auftritt (z.B. der Partner baut die Verbindung ab). 


Für das Ereigniskennzeichen EID wird DCAM einen Eintrag ("Егеідпіѕ”; 
"Signal”) machen, sobald die Ausführung erfolgreich oder nicht erledigt 
ist (z.B. die Nachricht im Benutzerspeicher eingetragen wurde oder die 
Wartezeit abgelaufen ist). 

Mit dem Aufruf SOLSIG (solicit signal) kann der Benutzer das Ereignis 
bzw. Signal zur Verarbeitung anfordern. Dieser SOLSIG-Aufruf kann 
wiederum synchron oder asynchron abgesetzt werden. 
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Synchroner SOLSIG (Bild 2-13): 


Er wird an der Stelle im Programm abgesetzt, ab der die Verarbeitung 


des Ereignisses erfolgt. Auch hier besteht die Wahl zwischen zwei 
Möglichkeiten: 


— Es wird gewartet, bis das Ereignis eintrifft, falls es nicht schon 
eingetroffen ist (Operand COND=UNCOND), die maximale Warte- 
zeit wird dabei festgelegt (Operand LIFETIM). Ist die SOLSIG-Warte- 
zeit abgelaufen, aber das (Erfolgs- oder Mißerfolgs-) Ereignis trat 
nicht ein und es ist auch kein Fehler aufgetreten, dann kann der 
SOLSIG nochmals für das gleiche Ereignis-Kennzeichen gegeben 
werden. 


— Der Aufruf wird sofort beendet (Parameter COND=IMMED). Falls 
das Ereignis noch nicht eingetroffen war, muß ggf. zu einem späte- 
ren Zeitpunkt der Aufruf wiederholt werden. 


27 80150 x 


Bild 2-13 Angaben bei synchroner Ausführung des SOLSIG 
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Asynchroner SOLSIG (Bild 2-14): 


Er kann unmittelbar nach dem 1. und 2. Schritt abgesetzt werden. Der 
Bezug zum Contingency-Kennzeichen COID, das im 2. Schritt (ENACO, 
siehe BS2000 Makroaufrufe) definiert wurde, wird durch die Angabe der 
Adresse des Feldes erreicht, in dem das Kennzeichen steht (Operand 
COID). - 


Trifft das (Erfolgs- oder Mißerfolgs-)Ereignis ein, wird die Contingency- 
Routine angestoßen, deren Kennzeichen hier angegeben wird. In dieser 
Routine kann der Benutzer das eingetroffene Ereignis verarbeiten. 


4 Bytes 


Einsprungadresse | 
der Contingency- . 4 Bytes 
| routine | | 


“СОЮВЕТ = relexp | 


Contingency- 


Kennzeichen 4 Bytes 


coD= relexp | 


Contingency-Routine | 


Bild 2-14 Angaben bei asynchroner Ausführung des SOLSIG 
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| Dies sind die notwendigen Schritte zur Ausführung eines asynchronen Befehls. Der Aufruf an 
E DCAM wird sofort abgeschlossen, zum Zeitpunkt also, an dem der Befehl von ОСАМ 

angenommen, an dem er aber u.U. noch nicht ausgeführt ist. Die Rückmeldung im verwende- 
ten Steuerblock sagt dann noch nichts aus über die Befehlsausführung von DCAM (Anhang 
A.2). Die Beendigung und Ausführung des Befehls erfährt der Benutzer nur, wenn er einen 
SOLSIG-Aufruf für das verwendete Ereigniskennzeichen gibt. 


Die Adresse des verwendeten Steuerblocks kann der Benutzer, wenn er sie nicht selbst 
sichern will, als Referenz des Aufrufs in dem Parameter EIDREF des Steuerblocks RPB 
angeben. Er bekommt sie dann entweder im Feld RPOSTAD (bei synchronem SOLSIG) oder 
im Register 3 der Contingency-Routine (bei asynchronen SOLSIG) übergeben. Damit kann er 
auf den Steuerblock zurückgreifen und die DCAM-Rückinformation über die Befehlsausfüh- 
rung auswerten (siehe auch Bild 2-15). 


Das höchstwertige Byte der Referenz wird von ОСАМ mit sedez. X’0C’ überschrieben. 


= = wi Festlegung durch Benutzer 
! (Konstante in Wortlänge) 


© 1. Fall: (ohne Contingency) | 
Übergabe im : 


501510 +» ВРОЅТАР Benutzerfeld 


| 
м 


3 Bytes: EIDREF 


oder 2. Fall: (mit Contingency) 


-- - + 


Contingency- 


SOLSIG ,,, COID= Kennzeichen der | Übergabe an Contigency 
Routine | 


Register 3: 


3 Bytes: EIDREF 


© Bild 2-15 Übergabe der Ereignis-Information 
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2.8 


Asynchrone DCAM-Meldungen 


DCAM gibt bestimmte Ereignisse im Datenkommunikationssystem spontan an den Benutzer 
weiter, wenn dieser dafür eine Unterbrechungsroutine (Contingency) definiert hat. Dies 
geschieht beim Eröffnen der DCAM-Anwendung (siehe 3.1ff.). Im Steuerblock ENB gibt der 
Benutzer dabei die Kennzeichen der Contingency-Routinen an, die er bei ihrer Definition mit 
dem Makroaufruf ENACO zurückerhalten hat. 


Diese Contingency-Routinen sind einem Prozeß fest zugeordnet. Ihre Kennzeichen können 
aber von mehreren DCAM-Anwendungen benutzt werden, wenn diese vom gleichen Prozeß 
eröffnet werden. 


Die einmal getroffene Zuordnung zwischen DCAM-Anwendung und Contingency-Routine 
kann für die Lebensdauer der DCAM-Anwendung nicht mehr geändert werden. 


Soll eine Contingency nicht oder nur unter Berücksichtigung anderer Routinen zum Ablauf 
kommen, kann ihr gezielt eine Priorität von 1 (niedrigste) bis 127 (höchste) zugeordnet werden 
(Makroaufruf LEVCO, siehe Manual "В52000 Makroaufrufe an den Ablaufteil’). Der Standard- 
wert ist 1. Die Hauptroutine kann damit schon unterbrochen werden, da sie standardmäßig die 
Priorität 0 hat. Aber auch sie kann ihre Priorität höher setzen und damit ggf. die Unterbre- 
chung zeitlich hinausschieben. 


An dem Beispiel der LOGON-Contingency wird in Bild 2-16 gezeigt, welche Angaben zur 
Definition unbedingt notwendig sind. 
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Einsprungadresse 
der Contingency 


ENACO COADAD = relexp 


Routine 


4 Bytes 


Contingency Routine 


Bearbeitung der Aufforderung zum Verbindungsaufbau 


Bild 2-16 Angabe bei Definition einer Contingency für DCAM-Ereignismeldungen 


Wird eine Contingency-Routine gestartet, erhält der Benutzer in verschiedenen Registern 
Informationen (siehe dazu die Tabellen der Registerbelegungen in Anhang A.3). Alle weiteren 
Register muß er selbst versorgen (auch die Basisregister). Auf Registerinhalte der unterbro- 
chenen Routine oder der Hauptroutine kann er mit dem Makroaufruf CONTXT (siehe Makro- 


aufrufe des Ablaufteils) zugreifen. 


Im folgenden werden die Ereignisse, die als asynchrone Meldung an das Programm gegeben 
werden können, im einzelnen beschrieben. 
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2.8.1 


LOGON 


Wenn eine Aufforderung zum Verbindungsaufbau an eine DCAM-Anwendung gerichtet wird, 
die die Eigenschaft ATTR=LOGON hat und deren aktueller Zustand gleich START ist, wird 
diese Meldung gegeben (siehe DCAM-Programmschnittstellen, 3.1). ОСАМ erwartet eine 
Reaktion des Benutzers auf diese Meldung; "keine Reaktion’ wird als Zurückweisung der 
Aufforderung zum Verbindungsaufbau interpretiert (nach einer im Kommunikationssystem 
für solche Ereignisse definierten Zeit). Die zu einer eventuellen Reaktion gebrauchten Funkti- 
onsaufrufe müssen nicht іп der 'LOGON-Contingency-Routine’ selbst abgegeben werden. 


Die durch die LOGON-Meldung angekündigte Aufforderung zum Verbindungsaufbau kann 
durch einen YOPNCON (OPTCD = ACCEPT; siehe 3.2.1.3)-Makroaufruf angenommen werden 
oder durch einen YREJLOG (siehe 3.2.3)-Makroaufruf zurückgewiesen werden. Um die 
nötigen Informationen für die Annahme (YOPNCON) der Aufforderung zu bekommen, muß 
der Benutzer einen entsprechenden YINQUIRE (siehe 3.2.2) Makroaufruf absetzen. 


Folgende Informationen werden beim Einsprung in die LOGON-Contingency-Routine überge- 
ben: | 


— Das Kennzeichen der DCAM-Anwendung (AID) in Register З. 


— Das Kennzeichen der Aufforderung zum Verbindungsaufbau (LID = logon identifier) in 
Register 4. 


— Die Länge der Verbindungsnachricht, die vom Partner gesendet wurde in 
Register 5. 


An einem Beispiel wird in Bild 2-17 gezeigt, welche Aufrufe verwendet werden, wenn eine 
LOGON-Contingency vorgesehen ist. 
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Р” 


Ргодгатт- 


ç Hauptroutine 
ENACO 00405 Жз» Eine Aufforderung zum 
YOPEN ........ | Абау einer Verbindung 
definieren anstoßen trifft ein 


LOGON-Contingency-Routine 


YINQUIRE Abholen der Verbindungsnachricht 
YOPNCON ACCEPT Verbindungsaufbau 
oder YREJLOG x Aufforderung zurückweisen 


9:9 See (р TO езеееееееееееееееееееееее 


Rücksprung 
YRECEIVE ` bei statischer Steuerblockerzeugung 2. 
YSEND 
YCLOSE 
YACB 
YENB bei statischer Steuerblockerzeugung 
YRPB 


Bild 2-17 Beispiel für die Anwendung einer LOGON-Contingency 


2.8.2 LOSCON 


Beim Verlust der Verbindung zu einem Partner auf Grund eines Verbindungsabbruchs durch 
den Operator des Kommunikationssystems oder durch den Partner selbst, wird diese Mel- 
dung gegeben. Wenn eine DCAM-Anwendung keine LOSCON-Contingency-Routine definiert 
hat, wird der Verlust einer Verbindung erst beim nächsten auf diese Verbindung bezogenen 
Aufruf bemerkt. 


Folgende Informationen werden beim Einsprung in die LOSCON-Contingency-Routine über- 
geben: 


© — Das Kennzeichen der DCAM-Anwendung (AID) in Register 3 
— Das Kennzeichen der Verbindung (CID) in Register 4 


— Die vom Benutzer in USERFLD hinterlegte Begleitinformation in 
Register 5 | 


— Der Grund für den Abbruch der Verbindung in Register 6 bzw. ob die Verbindung erst 
nach Ablauf der Vorwarn-Zeit abgebrochen wird. 
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2.8.3 


2.8.4 


2.8.5 


PROCON 


Sobald die DCAM-Anwendung eröffnet wurde bzw. am Bedienplatz das /BCIN-Kommando 
(siehe Manual "Administration und Dienste eines Datenkommunikationssystems’) für den 
Prozessor des Partners gegeben wurde, informiert DCAM diese Anwendung über die im 
Kommunikationssystem vordefinierten Partner (XSTAT, siehe Manual ‘Generierung eines 
Datenkommunikationssystems’) die zum Verbindungsaufbau aufgefordert werden sollen. 


Die PROCON-Contingency-Routine wird je definiertem Partner einmal zum Ablauf gebracht, 
damit eine Aufforderung zum Aufbau der Verbindung an ihn gerichtet werden kann. 


DCAM erwartet keine Reaktion auf diese Meldung. Bleibt sie aus, wird keine Verbindung 
aufgebaut. 


Folgende Informationen werden beim Einsprung in die PROCON-Contingency-Routine über- 
geben: 


— Das Kennzeichen der DCAM-Anwendung (АІ) in Register 3 
— Dersymbolische Name des Partners in Register 4und5 


— Der symbolische Name des Prozessors, an dem der Partner angeschlossen ist, in 
Register 6 und 7. 


COMEND 


Sobald das Kommunikations-Zugriffssystem beendet wird (SHUTDOWN) oder wenn ein 
Schließen der DCAM-Anwendung erzwungen wird (siehe 3.1.4, Schließen einer DCAM- 
Anwendung), erhält der Benutzer diese Meldung. Im Falle eines ‘SHUTDOWN’ bzw. eines 
erzwungenen Schließens wird die Anwendung von DCAM geschlossen. Es wird keine Reak- 
tion vom Benutzer erwartet. 


Im Falle einer entsprechenden Warnung kann keine DCAM-Anwendung mehr eröffnet werden 
bzw. keine Verbindung mehr aufgebaut werden. Nach einer bestimmten für das Kommunika- 
tionssystem vordefinierten Zeit (siehe Manual "Administration und Dienste eines Datenkom- 
munikationssystems’) wird ein 'SHUTDOWN’ bzw. ein ’erzwungenes Schließen’ durchge- 
führt. 


Folgende Informationen werden beim Einsprung in die COMEND-Contingency-Routine über- 
geben: 


— Das Kennzeichen der DCAM-Anwendung (AID) in Register 3 


— Die Ursache ('SHUTDOWN’ oder ’erzwungenes Schließen’, 'SHUTDOWN-’ oder 
'erzwungenes Schließen-Warnung‘) in in Register 4 


EXPR 


Wenn eine Expressnachricht für die DCAM-Anwendung angekommen ist, kann sie über diese 
Meldung sofort dem entsprechenden Programm zugestellt werden. In der Regel wird das 
Programm, welches den Primärprozeß steuert, die Expreßnachricht erhalten. Dies trifft zu, 
wenn 


— mit Verteilcodes gearbeitet wird; 


— ohne Verteilcodes gearbeitet wird und für diese Verbindung keine Verknüpfung zu 
einem Sekundärprozeß besteht (CS-Zustand). 
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2.8.6 


2.8.7 


Ein Sekundärprozeß erhält diese Meldung nur, wenn er auf der betreffenden Verbindung den 
CS-Zustand eingestellt hat. Auf einer Verbindung, die mit EDIT=SYSTEM definiert wurde, die 
also mit Logischen Datenstationen arbeitet, werden keine Expreßnachrichten an den Benutzer 
übergeben und damit auch keine EXPR-Meldungen erzeugt. 


Folgende Informationen werden beim Einsprung in die EXPR-Contingency-Routine überge- 
ben: 


- Das Kennzeichen der DCAM-Anwendung (AID) in Register 3 

— Das Kennzeichen der Verbindung, auf der die Nachricht ankam (CID) in Register 4 
— Die Begleitinformation der Verbindung (USERFLD) in Register 5 

— Der Inhalt der Expreßnachricht in den Registern 6 und 7 


— Die Laufnummer der Nachricht in Register 8. 


TACK 


Wenn eine Transportquittung für die DCAM-Anwendung angekommen ist, kann sie mit 
dieser Meldung sofort dem betroffenen Programm übergeben werden. 


Zur Identifikation der betreffenden Nachricht wird vom Benutzer beim Senden der Nachricht 
(YSEND) eine Laufnummer vergeben (5ЕОМО). 


Die Verteilung der Transportquittungen an eine mehrfach benutzbare DCAM-Anwendung 
erfolgt in Abhängigkeit von der Definition beim YOPEN des Primärprozesses (ATTR-Operand 
im ACB): 


— PRIMTASK: Alle Quittungen erhält der Primärprozeß..Somit ist es sinnlos, für 
einen Sekundärprozeß eine TACK-Contingency vorzusehen. 

— REOTASK: Die Quittung erhält der Prozeß, der die betreffende Nachricht gesen- 
det hat. 

— NOTACK: Es werden für diese DCAM-Anwendung keine Quittungen übergeben. 


Eine Definition einer Contingency-Routine wäre sinnlos. 


Folgende Informationen werden beim Einsprung in die TACK-Contingency-Routine überge- 
ben: 


- Das Kennzeichen der DCAM-Anwendung (AID) in Register З 

— Das Kennzeichen der Verbindung (CID) in Register 4 

— Die Begleitinformation der Verbindung (USERFLD) in Register 5 
— Die Anzeige, ob die Quittung positiv oder negativ ist, in Register 6 


— Die laufende Nummer der Nachricht, die quittiert wurde, in Register 7. 


SECOND 


Mit dieser Contingency kann sich ein Primärprozeß in 3 Fällen Informationen über einen 
Sekundärprozeß geben lassen: 


— Ein Sekundärprozeß eröffnet die Anwendung nach einem Primäprozeß 
— ein Sekundärprozeß meldet sich von der Anwendung ab 


— eine Nachricht trifft für einen Verteilungsnamen ein, der keinem Sekundärprozeß zugeord- 
net ist. 
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Folgende Informationen werden beim Einsprung in die SECOND-Contingency-Routine über- 
geben: 


— Das Kennzeichen der DCAM-Anwendung (AID) in Register 3 
— Der Grund für den Anstoß der SECOND-Contingency (s. oben) in Register 4 


— Der Verteilungsname (gegebenenfalls) in Register 5 und 6. 
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3 Anwendung der Funktionen von DCAM 


Bevor der Benutzer mit der Lektüre dieses Kapitels beginnt, sollte er unbedingt mit den 
Funktionen von DCAM vertraut sein, wie sie im Kapitel 3 von DCAM-Programmschnittstellen 
beschrieben sind. Er findet dort die gleiche Abfolge und Aufteilung des Kapitels wie hier. So 
kann er ohne weitere Querverweise, falls notwendig, in DCAM-Programmschnittstellen 
nachschlagen. 


Besonderer Wert wird darauf gelegt, zur Erleichterung der Einarbeitung die Schnittstelle 
möglichst einfach zu zeigen. Für jeden Aktionsaufruf an DCAM wird daher ein eigens dafür 
generierter Steuerblock verwendet (siehe Abschnitt 2.1). So können Angaben für Standard- 
werte entfallen. Der geübte Benutzer, der die Steuerblöcke auch mehrfach verwenden 
möchte, wird auf den alphabetisch geordneten Katalog verwiesen (Kapitel 4). In Kapitel 3 wird 
er jedoch die Inhalte der einzelnen Steuerblockfelder und ihre Auswertung nachschlagen. 


Für die verwendeten Abkürzungen siehe Anhang A.5. 


Eine weitere Hilfe soll die grafische Darstellung sein. Bild 3-1 zeigt, wie sie zu interpretieren ist. 
Zur besseren Übersicht kann es herausgeklappt werden. 


© Bei dieser Darstellung wird nicht berücksichtigt, in welcher Weise der Steuerblock vom 
Benutzer erzeugt wird (statisch oder dynamisch). 


Jede Makrobeschreibung wird durch mindestens ein Beispiel abgerundet. Diese Beispiele 
sind Codierskizzen eines Anwendungsfalles. Sie sind nicht vollständig ausgeführt und sind 
nicht als Muster anzusehen. Schon deshalb nicht, weil es unterschiedliche Möglichkeiten der 
Codierung gibt. 
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Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


alternative Angabe in einem Register 
eschreibung der einzelnen Felder) 


үрг == æ sma nn ama ur m SE) (siehe jeweils 


der beschrieben wird 


Die Ziffern beziehen sich 
auf die Konnektoren 

der Feldbeschreibungen 
(z.B. 1) 2) 3) usw.). 


wahlweiser Eintrag 
5 wahlweiser Eintrag 


Einträge von DCAM, 
wenn der Befehl u 
ausgeführt wurde | 


Eintrag von DCAM in ein Register 


DCAM 
gibt 
zurück 


Adressierung eines Steuerblocks mit gültigem Kennzeichen, 
oft alternativ zur obigen Angabe im Register 


wahlweiser Eintrag 


DCAM 
gibt 
zurück 


ausgeführt wurde 


Bild 3-1 Erklärung der grafischen Darstellung 
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3.1 Auf die Existenz einer DCAM-Anwendung bezogene Makroaufrufe 


Existenzbezogene Makroaufrufe werden im Zusammenhang mit der Erzeugung und Auflö- 
sung der DCAM-Anwendung gebraucht. Ferner gehören die Makroaufrufe dazu, mit denen die 
Zustände der DCAM-Anwendung zu ändern bzw. abzufragen sind. 


Die existenzbezogenen Makroaufrufe sind: 


— YOPEN Eröffnen einer DCAM-Anwendung 
— YCLOSE Schließen einer DCAM-Anwendung 
— YSETLOG Setzen des Zustandes einer DCAM-Anwendung 


— YINQUIRE Abfragen des Zustandes einer DCAM-Anwendung (Partner) 


Angaben zur dynamischen Namens-Zuweisung (LINK) sind hier weggelassen und werden in 
einem eigenen Abschnitt (3.4) behandelt. 


DCAM-Prozesse können die asynchrone Meldung 


— COMEND Beenden des Zugriffssystems und Schließen der DCAM-Anwendung 
(siehe auch 2.8.4) 


© in einer entsprechenden Contingency-Routine bearbeiten. 


Anmerkung: 


Sobald ein Batch-Task eine DCAM-Anwendung eröffnet, ändert DCAM sein Scheduling-Attri- 
but (siehe Manual PRIOR) auf “DIALOG”, falls der entsprechende JOIN-Eintrag den Task 
hierzu berechtigt. 


Sobald der Batch-Task seine letzte DCAM-Anwendung schließt, setzt DCAM ihn wieder auf 
“ВАТСН” zurück. 


3.1.1 Eröffnen einer DCAM-Anwendung 


Eine DCAM-Anwendung kann 

— einfach benutzbar sein (sie wird nur von einem Prozeß eröffnet) oder 

— mehrfach benutzbar sein (sie wird vom Primärprozeß und Sekundärprozessen eröffnet). 
© Wenn sie mehrfach benutzbar ist, kann Nachrichtenverteilung 

— nach dem Standardverfahren (absenderspezifisch/empfängerglobal) oder 

— anhand von Verteilcodes erfolgen. 


Aus diesen Möglichkeiten ergeben sich fünf unterschiedliche Varianten des Makroaufrufs 
YOPEN, die im folgenden beschrieben werden. 
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3.1.1.1 


Einfach benutzbare DCAM-Anwendung 


Es soll eine DCAM-Anwendung eröffnet werden, die nur einfach benutzbar ist. 


Es muß angegeben werden: 


1) Der Name der DCAM-Anwendung, wenn eine in der RDF vordefinierte Anwendung 
eröffnet werden soll. Wird kein Name angegeben, so wird er von DCAM erzeugt. Der 
Bezug zu dieser Anwendung muß dann über das Kennzeichen (AID) hergestellt werden, 
das von DCAM zurückgegeben wird. 


2) Das Kennwort, wenn eine vordefinierte Anwendung durch ein Kennwort geschützt ist. 


Weiterhin kann angegeben werden: 


3) daß Aufforderungen zum Verbindungsaufbau nicht bearbeitet werden sollen 
(NLOGON). Fehlt die Angabe, werden Aufforderungen bearbeitet (LOGON). 


4) Die Adresse des Steuerblocks ENB. Fehlt die Angabe, werden keine DCAM-Meldungen 
bearbeitet (siehe 2.8). 


5) Das Kennwort, das bei Aufforderung zum Verbindungsaufbau vom Partner angegeben 
werden muß. Fehlt diese Angabe, wird kein Kennwort verlangt. 


6) Die Adresse des Feldes, in das DCAM den symbolischen Namen des eigenen Prozessors 
einträgt. 


7) Die Adresse des Feldes, іп dem der Kettungsname steht. 


8) daß die Angaben im ACB mit den Informationen des CLT-Eintrags (CLT=Communica- 
tion Link Table) überschrieben werden sollen, der durch den Kettungsnamen identifi- 
ziert wird (PERM;permanente Änderung). Bei fehlender Angabe werden die Informatio- 
nen des CLT-Eintrags nur für diesen Aufruf ausgewertet. Die Angaben im ACB werden 
nicht verändert (TEMP;temporäre Änderung). 


9) die Nummer der DCAM-Version (z.B. 8.0), wenn bei dem Prozeß die folgenden neuen 
Funktionen dieser Version verwendet werden (bei fehlender Angabe wird eine DCAM- 
Version < 7.0 angenommen): 


— Übermittlung einer Verbindungsnachricht bei YOPNCON mit OPTCD=ACCEPT, 


Empfang der mit OPNCON (ACCEPT) übermittelten Verbindungsnachricht bei 
ҮОРМСОМ OPTCD=ACQUIRE, 


— Angabe der maximalen Nachrichtenlänge durch MAXLN-Parameter bei YOPNCON. 


Beispiel 


Die Anwendung, die eröffnet werden soll, soll einfach benutzbar sein. Ihr Name wird vom 


System erzeugt. Sie soll grundsätzlich keine Aufforderungen zum Verbindungsaufbau anneh- 
men. Sie verarbeitet keine asynchronen Meldungen. 


YOPEN АСВ-АСВ1 


АСВ1 ҮАСВ ATTR=NLOGON 
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Makroaufruf Steuerblöcke und Register 


ACB = addr 
YOPEN ACB 
Adresse des Steuer- 


blocks, der die 
DCAM-Anwendung 
Р ATTR = NLOGON | 
4 ENB = relexp 


beschreibt 
Ес C’konstante’ 
Ё Lo@pass = 4 Ckonstante, } 


D PRONAME = ге!ехр E 


LINK = relexp 
8 LINKMOD = PERM 
B DCAMVER = absexp 


ENB 


H PROCON = relexp 
COMEND = relexp 
EXPR = relexp | 


TACK = relexp 


4 LOSCON = ге!ехр 


LOGON = ге!ехр 


1) пиг in Verbindung mit EDIT = USER 
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SECOND =relexp 


Speicherbereiche im Benutzerprogramm 


8 Bytes 


Kettungsname 8 Bytes 


Contingency- je | 
Kennzeichen 4 Bytes 
3-5 


3.1.1.2 


Erstmaliges Eröffnen einer mehrfach benutzbaren DCAM-Anwendung 


Es soll eine DCAM-Anwendung eröffnet werden, die 


1) 


mehrfach benutzbar ist und ohne Verteilcodes arbeitet. 


Dazu muß ferner: 


2) 


3) 


der Name der DCAM-Anwendung vom Benutzer festgelegt werden. Es wird die Adresse 
eines Bereiches von 8 Bytes angegeben, in dem der Name steht. 


Das Kennwort, wenn eine vordefinierte Anwendung durch ein Kennwort in der RDF 
geschützt ist. 


Weiterhin kann angegeben werden, daß: 


4) 
5) 


б) 


7) 


8) 


9) 


der Prozeß ein Primärprozeß sein will (PRIMARY). Wird nichts angegeben, soll keine 
diesbezügliche Prüfung stattfinden (NO). 


DCAM-Meldungen (siehe 2.8) bearbeitet werden sollen. Dazu wird die Adresse des ЕМВ 
angegeben. Fehlt die Angabe, werden sie nicht bearbeitet. 


die DCAM-Anwendung vor dem unbefugten Anschluß eines Sekundärprozesses durch 
ein Kennwort geschützt sein soll. Die Angabe ist nur sinnvoll, wenn die Anwendung 
nicht vordefiniert und durch ein Kennwort in der RDF geschützt ist. Wird die Angabe 
dennoch verwendet, so ist das USEPASS-Kennwort gleich dem Kennwort in der RDF zu 
setzen. 


Aufforderung zum Verbindungsaufbau grundsätzlich nicht bearbeitet werden sollen 
(NLOGON). Fehlt die Angabe, werden sie bearbeitet. 


Transportquittungen an den anfordernden Prozeß geleitet werden sollen (REQTASK) 
oder nicht weitergeleitet werden sollen (МОТАСК). Fehlt die Angabe, werden sie ап den 
Primärprozeß übergeben (PRIMTASK). 


bei Aufforderung zum Verbindungsaufbau an diese DCAM-Anwendung ein Kennwort 
angegeben werden soll, das hier festgelegt wird. Fehlt die Angabe, ist es nicht 
erforderlich. 


Ferner kann man angeben: 


10) 


11) 
12) 


13) 


Die Adresse des Feldes, in das DCAM den symbolischen Namen des eigenen Prozessors 
einträgt. Fehlt die Angabe, werden sie nicht bearbeitet. 


Die Adresse des Feldes, in dem der Kettungsname steht. 


daß die Angaben im ACB mit den Informationen des CLT-Eintrags (CLT=Communica- 
tion Link Table) überschrieben werden sollen, der durch den Kettungsnamen identifi- 
ziert wird (PERM; permanente Änderung). Bei fehlender Angabe werden die Informatio- 
nen des CLT-Eintrags nur für diesen Aufruf ausgewertet. Die Angaben im ACB werden 
nicht verändert (TEMP; temporäre Änderung). 


die Nummer der DCAM-Version (z.B. 8.0), wenn bei dem Prozeß die folgenden neuen 
Funktionen dieser Version verwendet werden (bei folgender Angabe wird eine DCAM- 
Version < 7.0 angenommen): 


— Übermittlung einer Verbindungsnachricht bei YOPNCON mit OPTCD=ACCEPT; 
— Angabe der maximalen Nachrichtenlänge durch MAXLN-Parameter bei YOPNCON. 
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Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


voren eead ACB 


Adresse des Steuer- 
blocks, der die 
DCAM-Anwendung 
beschreibt 


VERIFY = PRIMARY 


ENB = relexp 


_ f C’konstante’ 
USEPASS = { ne} 


ATTR = NLOGON 
ATTR = | REQTASK |МОТАСК } 
_ J C’konstante’ 
LOGPASS = { X’konstante’ } 
PRONAME =relexp Р 


ШМК =ге!ехр 
12| LINKMOD = PERM 


DCAMVER = absexp 


Кате ер з [ге АЖС 


1 


Kettungsname 8 Bytes 


10 
2 


| А (Kennzeichen der 
| e DCAM-Anwendung) 


| Symbolischer Мате 
ке) des eigenen 
| Prozessors 


8 Bytes 


K (Rückmeldung, | 
siehe Anhang A.2) 


2 = x CLT-Information 


DCAM | 
gibt 
zurück 


ENB 
from FH == |ы. 
Ee mee 
Ee ТОГ 
rer ЖАЙ 
see Шилэн 
ra 


5| SECOND = relexp 
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3.1.1.3 


Beispiel 


Es soll eine DCAM-Anwendung erstmals eröffnet werden und den Namen APPL bekommen. 
Sie soll mehrfach verwendbar sein. Wenn ein Partner zum Verbindungsaufbau auffordert, soll 
er das Kennwort "УУХҮ27” angeben müssen. Wenn ein nachfolgender Prozeß die Anwendung 
eröffnet, soll er das Kennwort ‘ABCD’ angeben müssen. 


Es soll sichergestellt werden, daß dieser Prozeß der ersteröffnende Prozeß ist. 


YOPEN АСВ-АСВ1 
АСВ1 ҮАСВ АРРМАМЕ-МАНЕ, 
ATTR=SHARE, 


LOGPASS=C’WXYZ’, 

USEPASS=C’ABCD’, 

VERIFY=PRIMARY 
NAME DC CL8’ APPL’ 


Erstmaliges Eröffnen - Verwendung von Verteilcodes 


Es soll eine DCAM-Anwendung erstmalig eröffnet werden, an die 


1) Nachrichten anhand eines Verteilcodes verteilt werden sollen. 


Dazu ти% ferner: 
2) die DCAM-Anwendung mehrfach benutzbar sein. 


3) der Name der DCAM-Anwendung vom Benutzer festgelegt werden. Er steht in einem 
hier adressierten Feld von 8 Bytes Länge. 


4) дег Verteilungsname vom Benutzer festgelegt werden. Er steht ebenfalls in einem hier 
adressierten Feld von 8 Bytes Länge. 


5) Das Kennwort angegeben werden, wenn eine vordefinierte Anwendung durch ein 
Kennwort in der RDF geschützt ist. 


Weiterhin kann angegeben werden, daß: 


6) der Prozeß ein Primärprozeß sein will. Wird nichts angegeben, soll keine diesbezügliche 
Prüfung stattfinden. 


7) DCAM-Meldungen (siehe 2.8) bearbeitet werden sollen. Dazu wird die Adresse des ЕМВ 
angegeben. Fehlt die Angabe, werden sie nicht bearbeitet. 


8) die DCAM-Anwendung vor dem unbefugten Anschluß eines Sekundärprozesses durch 
ein Kennwort geschützt sein soll. Die Angabe ist nur sinnvoll, wenn die Anwendung 
nicht vordefiniert und durch ein Kennwort in der RDF geschützt ist. Wird die Angabe 
dennoch verwendet, so ist das USEPASS-Kennwort gleich dem Kennwort in der RDF zu 
setzen. 


9) bei Aufforderung zum Verbindungsaufbau an diese DCAM-Anwendung ein Kennwort 
angegeben werden soll. Fehlt die Angabe, ist es nicht erforderlich. 


10) Aufforderungen zum Verbindungsaufbau nicht bearbeitet werden sollen (NLOGON). 
Fehlt die Angabe, werden sie bearbeitet (LOGON). 


11) Transportquittungen an den anfordernden Prozeß geleitet werden sollen (REQTASK) 
oder nicht weitergeleitet werden sollen (NOTACK). Fehlt die Angabe, werden sie dem 
Primärprozeß übergeben (PRIMTASK). 
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Ferner kann man angeben: 


12) Die Adresse des Feldes,in das DCAM den symbolischen Namen des eigenen Prozessors 
einträgt. 


13) Die Adresse des Feldes,in dem der Kettungsname steht. 


14) daß die Angaben im ACB mit den Informationen des CLT-Eintrags (CLT=Communica- 
tion Link Table) überschrieben werden sollen, der durch den Kettungsnamen identifi- 
ziert wird (PERM;permanente Änderung). Bei fehlender Angabe werden die Informatio- 
nen des CLT-Eintrags nur für diesen Aufruf ausgewertet. Die Angaben im ACB werden 
nicht verändert (TEMP;temporäre Änderung). 


15) die Nummer der DCAM-Version (z.B. 8.0), wenn bei dem Prozeß neue Funktionen dieser 
Version verwendet werden. Bei fehlender Angabe wird eine DCAM-Version < 7.0 
angenommen. 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


ACB = addr 


YOPEN ACB 


Adresse des 
Steuerblocks, 

der die 
DCAM-Anwendung 
beschreibt 


8 Bytes 


8 Bytes 


6 VERIFY = PRIMARY 
ENB = relexp 
_ f C’konstante’ 
B USEPASS = e he } 
_ J C'konstante' 
° LOGPASS = желменен) 
D ATTR = NLOGON 
D АТТВ = | REQTASK | NOTACK } 
РКОМАМЕ = ге!ехр ® 
LINK =ге!ехр 


LINKMOD = PERM 
Ú DCAMVER = absexp 


س 


DCAM | 
gibt | 
zurück 


ENB 


DEER 
DEE BEE 
BEE Ee 
зө ШЕРИ 
"ee kt 
Б e — 
р 


4 Bytes 


Contingency- je 
ES Kennzeichen 


LOGON = relexp #3 
SECOND = relexp 
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3.1.1.4 


Beispiel 


Es wird eine DCAM-Anwendung eröffnet, die mit Verteilcodes arbeitet. Es soll überprüft 
werden, ob dies die erstmalige Eröffnung ist. Sekundärprozesse sollen das Kennwort 
Х”0000ЕРЕО” angeben. 

Transportquittungen sollen dem anfordernden Prozeß übergeben werden. Der Verteilungs- 
name für diesen Prozeß sei 'PRIMAER’. DCAM-Meldungen sollen bearbeitet werden. Der 
Verbindungsaufbau soll von den Partnern aus erfolgen, ein Kennwort wird nicht festgelegt. 
Der Name der Anwendung ist BUCHUNG’. 


Primärprozeß: 


ACB1 


ADDR1 
ENBAD 
DISAD 


YOPEN ACB=ACB1 

YACB APPNAME=ADDR1,, 
VERIFY=PRIMARY, 
ENB=ENBAD, 


ATTR=(SHARE, DISCO, REOTASK), 
DISNAME=DISAD, 
Ц5ЕРА55--Х” 0000ҒҒҒО” 


0С CL8’ BUCHUNG’ 
YENB eg 
DC CL8’ PRIMAER’ 


Nachfolgendes Eröffnen 


Es soll eine DCAM-Anwendung nachfolgend eröffnet werden. Die Nachrichtenverteilung soll 
über die empfängerglobale oder absenderspezifische Warteschlange erfolgen. Vorausset- 
zung ist, daß im Primärprozeß die Anwendung mit dem Attribut SHARE eröffnet wurde (siehe 
3.1.1.2). 


Dazu muß der Prozeß: 


1) 


2) 


3) 
4) 


den Namen der DCAM-Anwendung angeben. (Der Name muß mit dem vom Primärpro- 
zeß vergebenen identisch sein.) Er steht in einem hier adressierten Feld von 8 Bytes 
Länge. 


das Kennwort angeben, wenn die DCAM-Anwendung durch ein solches geschützt ist 
(durch die Angabe von USEPASS im Primärprozeß bzw. durch ein Kennwort in der 
RDF). \ 


wie im Primärprozeß das Attribut SHARE verwenden. 


die Nummer der DCAM-Version angeben, wenn dies im Primärprozeß geschehen ist. 
Die DCAM-Versionsnummer muß in Primär- und Sekundärprozeß übereinstimmen. 


Weiterhin kann angegeben werden: 


5) 


б) 
7) 


8) 


Die Adresse des Feldes, in das ОСАМ den symbolischen Namen des eigenen Prozessors 
einträgt. 


Die Adresse des Feldes, in dem der Kettungsname steht. 


daß die Angaben im ACB mit den Informationen des CLT-Eintrags (CLT=Communica- 
tion Link Table) überschrieben werden sollen, der durch den Kettungsnamen identifi- 
ziert wird (PERM; permanente Änderung). Bei fehlender Angabe werden die Informatio- 
nen des CLT-Eintrags nur für diesen Aufruf ausgewertet. Die Angaben im ACB werden 
nicht verändert (TEMP; temporäre Änderung). 


daß DCAM-Meldungen (siehe 2.8) bearbeitet werden sollen. In diesem Fall ist ein 
Steuerblock ENB zu adressieren. Fehlt die Angabe, werden sie nicht bearbeitet. 
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9) daß der Prozeß ein Sekundärprozeß sein will (SECONDARY). Fehlt die Angabe, wird 
© keine diesbezügliche Prüfung durchgeführt (NO). 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


ACB = addr 
YOPEN ACB 


Adresse des 
Steuerblocks, 

der die 
DCAM-Anwendung 
beschreibt 


8 Bytes 


4| DCAMVER = absexp 


EC 

seen kriss Jan 

° 
ла 


VERIFY = SECONDARY 


Kennzeichen der 
CAM-Anwendung) 


AID 


-wne (Rückmeldung, 
(FROR siehe Anhang A.2) 


` CLT-Information 


Rogister 15 (siehe Anhang A.2) _ 
1 | ғов2 | ЕРВЗ | ҒОВ4 | с | 
° | ІВуе 1 Byte 1Вуе | zurück | ` 


<ç ENB 


TACK = relexp 
nur wenn der Primärprozeß 
ATTR=REQTASK gegeben hat 


EXPR = ге!ехр 1 
B LOSCON = relexp 
8 SECOND = ге!ехр 


1) пиг in Verbindung mit EDIT = USER 
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Beispiel 


Es soll die DCAM-Anwendung aus dem ersten Beispiel (siehe 3.1.1.2) nachfolgend eröffnet 32 
werden. 


Es soll sichergestellt werden, daß dieser Prozeß ein Sekundärprozeß ist. 


Sekundärprozeß: 
YOPEN АСВ-АСВ1 
АСВ1 ҮАСВ АРРМАМЕ-МАМЕ, 
ATTR=SHARE, 
USEPW=C’ ABCD’ , 
VERIFY=SECONDARY 
NAME DC CL8’ APPL’ 


3.1.1.5 Nachfolgendes Eröffnen - Verwendung уоп Verteilcodes 


Wenn mit Nachrichtenverteilung anhand von Verteilcodes gearbeitet wird, setzt das nachfol- 
gende Eröffnen einer DCAM-Anwendung voraus, daß im Primärprozeß die Attribute SHARE ә 
und DISCO angegeben wurden (siehe 3.1.1.3). 


Dazu muß der nachfolgend eröffnende Prozeß: 


1) den Namen der DCAM-Anwendung angeben (der Name muß mit dem vom Primärpro- 
zeß vergebenen identisch sein). Er steht in einem hier adressierten Feld von 8 Bytes 
Länge. 


2) einen Namen angeben, unter dem er mit Verteilcodes arbeiten will (Verteilungsname). 
Er steht ebenfalls in einem hier adressierten Feld von 8 Bytes Länge. 


3) das Kennwort angeben, wenn die DCAM-Anwendung durch ein solches geschützt ist 
(durch die Angabe von USEPASS im Primärprozeß bzw. durch ein Kennwort in der 
RDF). 


4) wie im Primärprozeß das Attribut SHARE verwenden. 


5) die Nummer der DCAM-Version angeben, wenn dies im Primärprozeß geschehen ist. 
Die DCAM-Versionsnummer muß in Primär- und Sekundärprozeß übereinstimmen. 


Weiterhin kann angegebenen werden: ә 


6) Die Adresse des Feldes,in das ОСАМ den symbolischen Namen des eigenen Prozessors 
einträgt. 


7) Die Adresse des Feldes, in dem der Kettungsname steht. 


8) daß die Angaben im ACB mit den Informationen des CLT-Eintrags (CLT =Communica- 
tion Link Table) überschrieben werden sollen, der durch den Kettungsnamen identifi- 
ziert wird (PERM; permanente Änderung). Bei fehlender Angabe werden die Informatio- 
nen des CLT-Eintrags nur für diesen Aufruf gewertet. Die Angaben im ACB werden nicht 
verändert (TEMP). 


9) daß DCAM-Meldungen (siehe 2.8) bearbeitet werden sollen. Dazu wird die Adresse des 
ENB angegeben. Fehlt die Angabe, werden sie nicht bearbeitet. 


10) daß der Prozeß ein Sekundärprozeß sein will. Fehlt die Angabe, wird dies nicht 
überprüft. 
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Makroaufruf 


ACB = addr 
YOPEN ACB 


Adresse des 
Steuerblocks, 

der die 
DCAM-Anwendung 
beschreibt 


Steuerblöcke und Register 


Speicherbereiche im Benutzerprogramm 


| 8 Bytes 


| 8 Bytes 


5| DCAMVER = абѕехр 


AID 


FDBK (Rückmeldung, 
: siehe Anhang А.2) 


-= CLT-Information 


Register 15 (siehe Anhang А.2) 


FDB 1 FDB2 FDB3 FDB4 
| 1 Byte 1 Byte 1 Byte 1 Byte 


РКОМАМЕ = relexp 


LINK = геіехр 


Kettungsname 8 Bytes 


LINKMOD = PERM 


ENB = relexp 


VERIFY = SECONDARY 


Kennzeichen der 
CAM-Anwendung) 


Symbolischer Name 
des eigenen 
Prozessors 


| 8 Bytes 


DCAM 
gibt x 
zurück 


ENB 
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B LOSCON = relexp TE оне Kennzeichen 
B СОМЕНМР = relexp 


9 SECOND = ге!ехр 


Сопїїпдепсу- je 
4 Bytes 


TACK = relexp 
nur wenn der Primärprozeß 
ATTR=REQTASK gegeben hat 


Beispiel 


An die Anwendung, die im früheren Beispiel (siehe 3.1.1.3) vom Primärprozeß eröffnet wurde, ә 
soll пип ein Sekundärprozeß angeschlossen werden. Dabei soll geprüft werden, ob dies auch 
tatsächlich die nachfolgende Eröffnung ist. Asynchrone Meldungen sollen verarbeitet wer- 

den. Der Verteilungsname ist in diesem Fall ВОСН1?. 


Sekundärprozeß: 
YOPEN ACB=ACB1 

ACB1 YACB APPNAME=ADDR1, 
VERIFY=SECONDARY, 
ENB=ENBAD, 
ATTR=SHARE, 
DISNAME=DISAD, 
USEPW=X ’O000FFFO’, 

ADDR1 DC CL8’ BUCHUNG’ 

ENBAD YENB Хо 

DISAD DC CL8'BUCH1 ' ә 
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3.1.2 Verändern des Zustands einer DCAM-Anwendung 


Voraussetzung ist, daß diese DCAM-Anwendung Aufforderungen zum Verbindungsaufbau 
bearbeitet, d.h., beim YOPEN (siehe 3.1.1.1 bis 3) wurde das Attribut LOGON gesetzt. 


Nunmehr kann mit YSETLOG: 


1) der Zustand START (Aufforderungen werden bearbeitet) oder STOP (Aufforderungen 
werden momentan nicht bearbeitet) eingestellt werden. Nach obiger Voraussetzung ist 
vor dem ersten YSETLOG der Zustand START gegeben. Wird hier keine Angabe 
gemacht, wird STOP eingestellt. 


Dazu kann angegeben werden: 
2) Die Adresse des Steuerblocks ACB, in dem das gültige Kennzeichen (AID) steht oder 
ein Register, welches das gültige Kennzeichen enthält. 


Diese Angabe kann entfallen, wenn das Kennzeichen vorher (z.B. mit YMODCB) in den 
RPB eingetragen worden ist. 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 
Register n 
AID = (register) 

p — — — езе = = AID (Kennzeichen der Anwendung) 

! Nummer des Registers 
RPB = addr 

YSETLOG RPB 

Adresse des 


Steuerblocks, der 
den Aufruf 
beschreibt 


- OPTCD = START 
ACB = relexp 


FDBK (Rückmeldung, 
siehe Anhang A. 2) 


"Register 15 (siehe Anhang A.2) 
FDB 1 FDB2 FDB3 FDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 
| Steuerblock mit gültigem Kennzeichen AID 


DCAM 
gibt 
zurück 
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Beispiel 


Der Primärprozeß, der die DCAM-Anwendung APPL eröffnet hat, soll bis auf weiteres keine 
Aufforderung zum Verbindungsaufbau bearbeiten. Nach einer gewissen Zeit soll er wieder 
Aufforderungen zum Verbindungsaufbau bearbeiten. 


Bedeutung: 
YOPEN ACB=ACBNAM 
YSETLOG RPB=RPBNAM баг Zustand wird auf 
; STOP gesetzt 
YSETLOG RPB=RPBNAM, Dar Zustand wird auf 


OPTCD=START START gesetzt (RPB- 
Operand wird neu 
gesetzt). 


ACBNAM YACB APPNAME=NAME, 
ATTR=LOGON 

RPBNAM YRPB ACB=ACBNAM 

NAME DC CL8’APPL’ 
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3.1.3 . Abfragen des Zustands einer DCAM-Anwendung 


Es kann der Zustand einer DCAM-Anwendung abgefragt werden. 


Dazu muß angegeben werden: 
1) Die Bezeichnung der Variante des YINQUIRE, die hier verwendet wird. 


2) Der Name der DCAM-Anwendung, deren Zustand abgefragt werden soll. Es muß eine 
Anwendung in demselben Verarbeitungsrechners sein. Es kann die gleiche Anwendung 
sein, die auch in 4) adressiert wird. 


3) Ein Feld von 8 Bytes, das die Information aufnehmen soll. 


Es kann angegeben werden: 
4) Die Adresse des Steuerblocks ACB, in dem das gültige Kennzeichen (AID) steht oder 
ein Register, welches das gültige Kennzeichen enthält. 


Diese Angabe kann entfallen, wenn das Kennzeichen vorher (z.B. mit YMODCB) in den 
RPB eingetragen worden ist. 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


AID = (register 
ln REGEN Register n 
Nummer des Registers 


d AID (Kennzeichen der Anwendung) 
CID = (register) 
үет == == өле == = =+ Register m 

: [ Nummer des Registers 
| i : CID (Kennzeichen der Verbindung) 
ñ 

RPB = addr 

RPB 

Adresse des 

Steuerblocks, 

der den Aufruf 

beschreibt 


ACB = relexp 
CCB = relexp 


22 FDBK (Rückmeldung 


DCAM 
gibt 
zurück 


siehe Anhang A.2) 


 ЕОВ4 
1 Byte 


` Register 15 (siehe Anhang ^.2) 
< 4 i Dye Feld für Partner- 
, charakteristika 48 Bytes 
| (siehe Anhang А.4) | 


CCB 


Steuerblock mit еке 
Кеппгеісһеп СІ 


АСВ 


Steuerblock mit оп 
Kennzeichen А! 
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Die Information ist folgende: 


Byte 


X'00': Die Anwendung ist eröffnet und verarbeitet Aufforderungen zum Verbindungsauf- 
bau (ATTR=LOGON; Zustand START). 


X'04': Die Anwendung ist eröffnet und verarbeitet momentan keine Aufforderungen zum 
Verbindungsaufbau (ATTR=LOGON; Zustand STOP). 


X'08': Die Anwendung ist eröffnet und verarbeitet keine Aufforderungen zum Verbin- 
dungsaufbau (ATTR=NLOGON). 


ХОС: Die Anwendung wurde noch nicht erzeugt (von einem Primärprozeß eröffnet), d.h., 
sie existiert nicht. 


Beispiel 


Der Primärprozeß der DCAM-Anwendung, deren Kennzeichen (AID) sich im Register 9 
befindet, möchte Informationen über den Zustand der DCAM-Anwendung mit dem symboli- 
schen Namen ‘APPL’ einholen. 


YINQUIRE RPB=RPB2,AID=(9) 


RPB2 YRPB OPTCD=APPSTAT, 
АНЕА-АРРМАМЕ, 
AAREA=INFFELD 
APPNAME DC CL8’APPL’ 
INFFELD DS CL8 
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Schließen einer DCAM-Anwendung 


YCLOSE durch einen Sekundärprozeß: 


— Die DCAM-Anwendung wird ausschließlich für diesen Prozeß geschlossen. Bei einer 
definierten SECOND-Contingency (siehe 2.8.7) wird diese angestoßen. 


YCLOSE durch einen Primärprozeß: 


— Die DCAM-Anwendung wird aufgelöst, d.h. die DCAM-Anwendung wird für diesen Prozeß 
und für alle zu dieser Anwendung gehörigen Sekundärprozesse geschlossen. 


— Es werden alle in diesem Moment bestehenden Verbindungen abgebaut. 
— Anstehende Anforderungen von DCAM-Funktionen werden aufgehoben. 
— Angekommene, aber an den Prozeß noch nicht übergebene Daten gehen verloren. 


— Die zu dieser Zeit in einer Warteschlange eingetragenen Aufforderungen zum Verbin- 
dungsaufbau werden von DCAM zurückgewiesen. 


Für die von diesem YCLOSE-Aufruf betroffenen Sekundärprozesse gilt: 


— Wenn der Sekundärprozeß eine COMEND-Contingency-Routine definiert hat, wird er 
durch ein Verzweigen auf diese Routine vom Schließen der DCAM-Anwendung benach- 
richtigt. 


— Ist keine COMEND-Contingency-Routine definiert worden, so wird der Prozeß beim 
nächsten Makroaufruf, der sich auf diese DCAM-Anwendung bezieht, die Rückmeldung 
'"DCAM-Anwendung nicht eröffnet‘ (siehe Anhang A.2) davon unterrichtet, daß die 
Anwendung bereits geschlossen ist. 


Dazu muß angegeben werden: 
Entweder die Adresse des Steuerblocks ACB, іп dem das gültige Kennzeichen AID steht oder 


ein Register, in dem das gültige Kennzeichen steht. 
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Register n 


AID = (register) 
шы: тте шеш aman (таз қылы man хоо AID (Kennzeichen der Anwendung) 
{ Nummer des Registers 


ACB = addr 
YCLOSE ACB 


Adresse des Steuer- 

blocks, der die Steuerblock mit aktuellem 
DCAM-Anwendung Kennzeichen der DCAM- 
beschreibt Anwendung (AID) 


(Rückmeldung, 


FDBK siehe Anhang A.2) 


DCAM 
gibt 
zurück 


Register 15 (siehe Anhang A.2) 


FDB 1 FDB2 FDB З FDB 4 
1 Byte 1 Byte 1 Byte 1 Byte 
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3.2 


Beispiel 


Die unter dem Namen 'APPL' eröffnete DCAM-Anwendung soll geschlossen werden. 


YOPEN АСВ-АСВМАМ 


YCLOSE АСВ-АСВМАМ 
ACBNAM YACB АРРМАМЕ-МАМЕ 
МАМЕ DC CL8'APPL' 


Auf eine Verbindung bezogene Makroaufrufe 


Bevor Kommunikationspartner Nachrichten übermitteln können, müssen sie eine Verbindung 
aufbauen. Einer der Partner fordert zum Verbindungsaufbau auf. Die Aufforderung wird dem 
anderen Partner durch das Kommunikationssystem übermittelt. Informationen über den 
auffordernden Partner kann er abfragen. Er kann die Aufforderung annehmen oder zurückwei- 
sen. Bestimmte Eigenschaften der Verbindung können für eine bestehende Verbindung 
wieder geändert werden. Die Verbindung kann von jedem der Partner jederzeit abgebaut 
werden. 


Die verbindungsbezogenen Makroaufrufe sind: 


- ҮОРМСОМ Aufbau einer Verbindung (auffordern/annehmen) 


— YINQUIRE Abfragen von Informationen über die Verbindung und verbundene 
Partner 
— YREJLOG Zurückweisen einer Aufforderung zum Verbindungsaufbau 


— ҮСНАМСЕ Ändern von Eigenschaften einer Verbindung 
- YCLSCON Rücknahme einer Aufforderung bzw. Abbau einer Verbindung 


Angaben zur dynamischen Namen-Zuweisung (LINK) werden in einem eigenen Abschnitt (3.4) 
behandelt. 


DCAM-Prozesse können die asynchronen Meldungen 


— LOGON Aufforderung zum Verbindungsaufbau 
— LOSCON Verlust der Verbindung 
— PROCON Zur Verbindung vorgeschlagener Partner 


— Erfolgter Verbindungsaufbau 


in einer entsprechenden Contingency-Routine bearbeiten (siehe 2.7.2 und 2.8). 
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3.2.1 Aufbau einer logischen Verbindung 


Zum Aufbau einer Verbindung kann 

— aufgefordert werden; 

— eine Aufforderung angenommen werden. 

Ferner kann man sich an eine vordefinierte Verbindung anschließen. 


Je nach Verfahren der Nachrichtenverteilung 


— wird die Art der Warteschlange (absenderspezifisch oder empfängerglobal) 
— oder die Zuordnung von Verteilcodes zur Verbindung festgelegt. 


Daraus resultieren vier Varianten des Makroaufrufs YOPNCON. Die Unterschiede, die aus der 
synchronen oder asynchronen Ausführung eines Befehls entstehen, werden hier nicht als 
eigene Varianten gezeigt (siehe 3.2.1.3), sondern nur soweit sie DCAM betreffen, innerhalb 
der drei Varianten. 


Die Verbindung, die aufgebaut werden soll, wird in einem eigenen Steuerblock beschrieben, 
dem CCB. Er wird beim YOPNCON im RPB adressiert. 


© Hinweis: 
Der YOPNCON zerstört im RPB die Verweisadresse zum verwendeten CCB. Dadurch wird der 
Versuch verhindert, eine Verbindung irrtümlicherweise zweimal aufzubauen. 


Abhilfe: YOPNCON explizit mit dem Schlüsselwort CCB=ccbnam verwenden. 
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3.2.1.1 


Beschreibung der aufzubauenden Verbindung 


Der Steuerblock CCB muß, um eine Verbindung aufbauen zu können, die Werte enthalten, 
welche die Verbindung beschreiben. Er wird mit YCCB bzw. YGENCB erzeugt und kann 
folgende Eintragungen enthalten: 


1) Die Adresse eines Feldes von 8 Bytes Länge, das den Namen des Kommunikationspart- 
ners enthält und die Adresse eines Feldes von 8 Bytes Länge, das den Prozessornamen 
des Partners enthält. Die Angaben erfolgen von DCAM, wenn mit einem YOPNCON mit 
OPTCD=(ACCEPT,ANY) die Aufforderung eines beliebigen Partners angenommen 
werden soll (siehe 3.2.1.3). 


2) Die Begleitinformation in der Länge von 4 Bytes, die später (bei YRECEIVE ANY; bei 
LOSCON-, TACK- oder EXPR-Meldung) von DCAM dem Programm übergeben werden 
soll. 


Angaben über die Behandlung von Nachrichten, wie: 


3) Веі zu langen Nachrichten sollen die Nachrichtenreste aufgehoben werden (KEEP) für 
einen zweiten YRECEIVE. 


Fehlt diese Angabe wird der Rest weggeworfen (TRUNC). 


Diese Angabe wird nur wirksam, wenn beim YRECEIVE dies verlangt wird 
(OPTCD=CCBTK). Sonst gelten dann die dort gemachten Angaben. 


4) Die Nachrichten sollen als Bitmuster im Kommunikationssystem ohne Codeüberset- 
| zung übermittelt werden (BINARY). Voraussetzung ist, daß auch EDIT=USER gesetzt 
wurde (siehe weiter unten). 


Fehlt die Angabe, wird die Nachricht im Code des eigenen Verarbeitungs * rechners von 
DCAM erwartet bzw. übergeben (SYSCODE). 


5) Falls es beim Senden von Nachrichten zu einer Überlastung der Verbindung gekommen 
151, soll der Benutzer nach Auflösung des Rückstaus durch ein GO-Signal aufgefordert 
werden, das Senden wieder aufzunehmen (SIGNAL). 


Fehlt diese Angabe, wird kein GO-Signal gegeben. 


6) Die Datenübermittlung soll von dieser Anwendung begonnen werden (APPSTART). 
Ohne Angabe wird nichts festgelegt (ANYSTART). 


7) Es sollen Logische Datenstationen beim Senden und Empfangen von Nachrichten 
verwendet werden (EDIT=SYSTEM). Ist der Partner eine DCAM-Anwendung muß diese 
Angabe entfallen (EDIT= USER). 


Falls EDIT=SYSTEM eingestellt wurde, kann angegeben werden: 
8) Die Art der Logischen Datenstation für den Empfang von Nachrichten: 


EDITIN = 


— PHYS Der Benutzer erhält die Nachricht, wie sie die Datenstation erzeugt hat. 
Nachrichtenköpfe werden im Gerätecode empfangen. Dabei wird vom 
System eine Reassemblierung geblockter Nachrichten unterstützt und 
ggf. Kleinbuchstaben übergeben. 


— FORM Es wird die Formatsteuerung für Nachrichten verwendet. 


Fehlt die Angabe, wird EDITIN=LINE angenommen: 
Verwendung der Zeilen-Datenstation. 


DCAM V8.0A DCAM Makroaufrufe, U987-J-Z75-2 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


Der ССВ wird nicht CCB 
durch einen Makro- 
aufruf adressiert, 
sondern im RPB, der 
einen Makroaufruf 
beschreibt. 


C’konstante’ 
X’konstante’ 
USERFLD =< F’konstante’ 

A e d 
V(konstante 


DES 
DEE 
DE 
DESS 


_ J C’konstante’ 
LOGPW = Төле) 


DES 
DES 
DES 


Kettungsname 


Beschreibung der Verteilcodes 
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9) 


10) 


11) 


12) 


13) 
14) 
15) 
16) 


Behandlung ankommender Nachrichten: 


Bei LINE/FORM: Backspace-Zeichen sollen nicht ausgewertet, sondern dem Benutzer 
übergeben werden (GETBS). 


Bei LINE: 


— der logische Funktionstastencode der Datenstation soll als erstes Zeichen überge- 
ben werden (GETFC). 


— Es sollen Kleinbuchstaben übergeben werden (LCASE). 


Fehlen die Angaben, werden Backspace-Zeichen ausgewertet und nicht übergeben 
(NGETBS), wird der logische Funktionstastencode nicht übergeben (NGETFC), werden 
alle evtl. vom Partner gesendeten Kleinbuchstaben umgesetzt in Großbuchstaben 
(NLCASE). 


Die Art der Logischen Datenstation für das Senden von Nachrichten: 
EDITOUT= 


— PHYS Der Benutzer baut die Nachricht incl. Kopflängenbyte so auf, wie sie die 
Datenstation verstehen kann, den Nachrichtenkopf * im Gerätecode. 


— FORM Es wird die Formatsteuerung für Nachrichten verwendet. 


Fehlt die Angabe, wird EDITOUT=LINE angenommen: 
Verwendung der Zeilen-Datenstation. 


Behandlung der an das System zum Senden übergebenen Nachrichten: 


Bei LINE bzw. РНҮ5 (Datensichtstationen 8151, 8152, 816Х, 9750): 

Die Nachricht soll auf dem ап der Datensichtstation angeschlossenen Drucker zusätz- 
lich ausgegeben werden (HCOPY). Fehlt die Angabe, wird sie nicht auf dem Drucker 
ausgegeben (NHCOPY). 


Es ist zu prüfen, ob ein solcher Drucker auch angeschlossen ist, ggf. durch eine Abfrage 
der Partnercharakteristika (siehe 3.2.2.3). 


Bei LINE: Die Nachricht soll unstrukturiert ausgegeben werden (HOM). Fehlt die 
Angabe, wird die Nachricht strukturiert ausgegeben, d.h. jede logische Zeile wird als 
Einheit behandelt (МНОМ). 


Bei LINE (Datensichtstationen 975X und 816X): 
Die Ausgabedaten sind durch das System geschützt (EXTEND) 


Es werden keine logischen Steuerzeichen einer Nachricht ausgewertet (NLOGC); alle 
Zeichen < Х'40' werden durch SUB (Schmierzeichen) ersetzt (z.B. Ausgabe von 
Druckernachrichten auf Terminal). 


Bei LINE: 
Es werden logische Quittungen von der Druckerstation angefordert (LACK). 


Die Angabe zum Datenübermittlungsprotokoll ist vorgesehen, wird aber erst in einer 
späteren Version des BS2000 unterstützt, d.h. es wird z.Zt. vorausgesetzt, daß der 
Benutzer evtl. selbst Definitionen trifft und die Nachrichten danach bearbeitet (DEPRO- 
T= USER). 


Erläuterung siehe YOPNCON ACQUIRE (Auffordern zum Aufbau: siehe 3.2.1.2). 
Beschreibung der Verteilcodes siehe eigenen Abschnitt (3.2.1.4). 
Die Adresse des Feldes, in dem der Kettungsname steht. 


Die Angaben im CCB sollen mit den Informationen des CLT-Eintrags (CLT=Communi- 
cation Link Table) überschrieben werden, der durch den Kettungsnamen identifiziert 
wird (PERM;permanente Änderung). Bei fehlender Angabe werden die Informationen 
des CLT-Eintrags nur für diesen Aufruf ausgewertet. Die Angaben im CCB werden nicht 
verändert (TEMP;temporäre Änderung). 
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17) Maximale Länge der Nachrichten, die von der DCAM-Anwendung auf dieser Verbin- 
dung gesendet werden sollen. Dieser Wert dient der Optimierung der vom System 
bereitgestellten Puffer; er wird nicht an den Kommunikationspartner weitergegeben. 


Die Eintragungen von DCAM in den CCB sind abhängig von den Varianten des YOPNCON und 
werden darum dort beschrieben (siehe folgende Abschnitte). 
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3.2.1.2 


Auffordern zum Aufbau 


Bei dieser Variante (keine Verwendung von Verteilcodes) müssen bei der Eröffnung der 
DCAM-Anwendung die Attribute NSHARE (siehe 3.1.1.1) oder SHARE mit NDISCO (siehe 
3.1.1.2) gesetzt worden sein. 


Dazu muß angegeben werden: 


1) 


2) 


die Adresse des Steuerblocks CCB, in dem die aufzubauende Verbindung beschrieben 
ist. 


daß zu einem Aufbau aufgefordert werden soll. 


Weiterhin kann angegeben werden, 


3) 


4) 


5) 


б) 


7) 


8) 


9) 


Die Adresse des Steuerblocks АСВ, der das gültige Kennzeichen der Anwendung (АІ) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. Diese Angabe kann entfallen, 
wenn das Kennzeichen vorher (z.B. mit YMODCB) in den RPB eingetragen worden ist. 


Die Adresse eines Bereichs, in dem die mit der Aufforderung zu übermittelnde Verbin- 
dungsnachricht steht, ferner die Länge dieser Nachricht (höchstens 80 Bytes). 


Die Adresse eines Bereichs, in dem die Verbindungsnachricht des Kommunikations- 
partners von DCAM abgelegt werden soll, ferner die Länge dieser Nachricht (höchstens 
80 Bytes). 


Diese Angabe wird nur ab DCAM-Version 8.0 ausgewertet (d.h. DCAMVER =8.0). 


daß die Nachrichtenverteilung über die absenderspezifische Warteschlange erfolgen 
soll (CS). Wird nichts angegeben, so wird die empfängerglobale Warteschlange einge- 
stellt (CA). Dies kann bei der Datenübermittlung wieder geändert werden. 


daß der Befehl asynchron ausgeführt werden soll (ASY). Die synchrone Ausführung 
wird eingestellt (SYN), wenn nichts angegeben wird. 


die Adresse eines Feldes von 4 Bytes Länge, in dem das Ereigniskennzeichen steht, 
jedoch nur, wenn der Befehl asynchron ausgeführt werden soll. Dann jedoch darf die 
Angabe nicht entfallen (siehe auch 2.7.2). 


Eine Ereignisinformation, die übergeben werden soll, wenn der asynchron ausgeführte 
Befehl beendet wird. Das 1. Byte wird bei der Rückgabe mit X’0C’ überschrieben. 


Fehlt die Angabe, wird keine Information übergeben. 


Im Steuerblock CCB ist die Verbindung zu beschreiben (siehe 3.2.1.1), dabei ist, falls 
erforderlich, anzugeben: 


12) 


Das Kennwort zum Aufbau der Verbindung (LOGPW), wie es vom Partner vorgeschrie- 
ben wurde, wenn der Partner eine DCAM-Anwendung ist. 
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AID = i 
г AM ner E m алы Ri Register n 


i Nummer des Registers | 
AID (Kennzeichen der DCAM-Anwendung) 


RPB = addr 
YOPNCON opp 


Adresse des Steuerblocks, 


der den Aufruf beschreibt CCB = relexp 


OPTCD = ACQUIRE 


ACB = relexp 

AREA = relexp n Bytes 
AREALN = absexp (п < 80) 

AREA =relexp 


AAREALN = absexp 


OPTCD = CS 


4 Bytes 


CID (Kennzeichen der Verbindung) 


USER (Begleitinformation, wie 
sie in USERFLD des CCB 
festgelegt worden ist). 


D abhängig von der maximalen Paketlänge bei Transfer zu einem angeschlossenen Rechner, bzw. von einer Systemkonstanten bei 
© Übermittlung innerhalb des Verarbeitungsrechners 


ARECLN(Länge der empfangenen 
Verbindungsnachricht oder- 

bei zu langer Nachricht-Länge 
des abgeschnittenen Restes) 


FDBK (Rückmeldung qaa 
siehe Anhang A.2) J rück 


Register 15 (siehe Anhang A.2) 
FDB1 FDB2 FDB3 FDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 


Steuerblock mit aktuellem Kenn- 
. zeichen der DCAM-Anwendung (AID) 


CCB | 


Angaben zur Verbindung 


_ f C’konstante’ 
LOGPW = ымм, 


CID (Kennzeichen der Verbindung) 


MAXLN (Maximale Länge der auf 
dieser Verbindung 
sendbaren Nachrichten’) 


PTNCHA 1 (Die ersten 4 Bytes der 


artnercharakteristika, 
siehe Anhang A A dr a 
i 
EDIT (Vom Partner akzeptierte к 


Verwendung logischer 
Datenstationen: der Inhalt 
ist USER oder SYSTEM) 


PPROC (APPSTART/ANYSTART, wie 
vom Partner vorgeschlagen) 


DEPROT (USER/SYSTEM, wie vom 
artner vorgeschlagen) 
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Beispiel 


Es soll mit dem Partner “РТМ1”, der an Prozessor PROZ angeschlossen ist, eine Verbindung 
aufgebaut werden. Der Befehl soll asynchron ausgeführt werden. Der Benutzer will von der 


Beendigung des Befehls in einer Contingency-Routine benachrichtigt werden. Da schon 
mehrere asynchrone Befehle gegeben wurden, möchte der Benutzer erkennen, welcher von 
diesen beendet wurde. Dazu hinterlegt er eine private Kennung im RPB-Steuerblockfeld 
EIDREF (z.B. die Zeichenfolge 'PT1'). 


RPBNAM 


ACBNAM 
CCBNAM 


CONTAD 


ENAEI 


ENACO 


YOPNCON 


SOLSIG 


YRPB 


RETCO 


EINAME=EVENT, 
EIIDRET=EIDAD 
CONAME=CONTGY, 
COADAD=COAD, 
COIDRET=COIDAD 


RPB=RPBNAM 


EIID=EIDAD, 
COID=COIDAD 


ACB=ACBNAM, 
CCB=CCBNAM, 
OPTCD=(ACQUIRE,ASY), 
EID=EIDAD, 

EIDREF=C’ РТТ” 


РТММАМЕ--МАМ1, 
PRONAME=NAM2 
F 

F 

CL8’ PTN1 
CL8’ PROZ’ 
A(CONTAD) 
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3.2.1.3 


Annahme einer Aufforderung 


Die Annahme der Aufforderung zum Aufbau einer Verbindung ist nur dann nötig, wenn die 
Anwendung Aufforderungen bearbeitet (Attribut LOGON und Zustand START). Die in diesem 
Abschnitt dargestellte Variante des YOPNCON setzt zudem voraus, daß die Anwendung 
entweder mit dem Attribut NSHARE (siehe 3.1.1.1) oder den Attributen SHARE, NDISCO 
(siehe 3.1.1.2) eröffnet wurde. 


Dazu muß angegeben werden: 


1) 


die Adresse des Steuerblocks ССВ, in dem die aufzubauende Verbindung beschrieben 
ist (siehe 3.2.1.1). 


Weiterhin kann angegeben werden: 


2) 


3) 


4) 


9) 


6) 


7) 


8) 


9) 


10) 


ob die Aufforderung eines bestimmten Partners (SPEC) angenommen werden soll (der 
im CCB genannt ist). Fehlt die Angabe, wird jede beliebige Aufforderung angenommen 
(ANY). 


die Adresse des Steuerblocks ACB, der das gültige Kennzeichen (AID) enthält oder ein 
Register, welches das gültige Kennzeichen enthält. 


Diese Angabe kann entfallen, wenn das Kennzeichen vorher (z.B. mit YMODCB) in den 
RPB eingetragen worden ist. 


daß die Nachrichtenverteilung über die absenderspezifische Warteschlange erfolgen 
soll (CS). Wird nichts angegeben, so wird die empfängerglobale Warteschlange einge- 
stellt (CA). Dies kann bei der Datenübermittlung wieder geändert werden. 


daß der Befehl asynchron ausgeführt werden soll (ASY). Die synchrone Ausführung 
wird eingestellt (SYN), wenn nichts angegeben wird. 


Die Adresse eines 4 Bytes langen Feldes, in dem das Ereigniskennzeichen steht, jedoch 
nur, wenn der Befehl asynchron ausgeführt werden soll. Dann jedoch kann die Angabe 
nicht entfallen (siehe 2.7.2). 


Eine Ereignisinformation, die übergeben werden soll, wenn der asynchron ausgeführte 
Befehl abgeschlossen wurde. Das erste Byte wird bei der Rückgabe mit ХОС” über- 
schrieben. 


Fehlt die Angabe, wird keine Information übergeben. 


Ob der Aufruf, wenn momentan keine Aufforderung vorliegt, warten soll. Werden 
mehrere Aufrufe für einen bestimmten Partner (SPEC) oder beliebige Partner (ANY) 
ausgegeben, so werden die Aufrufe in eine Warteschlange eingetragen. Bei asynchro- 
ner Ausführung kann die Angabe nicht entfallen (О). 


Fehlt die Angabe, wird der Aufruf sofort beendet (NO), auch wenn keine Aufforderung 
vorliegt. 


Wenn vorige Angabe gemacht wurde, kann eine maximale Wartezeit definiert werden. 
Die Angabe. “0/ bedeutet, daß unbegrenzt gewartet werden soll. Ohne Angabe wird 
automatisch eine Zeit von 600 Sekunden eingestellt. 


Adresse eines Bereichs, in dem die zu übermittelnde Verbindungsnachricht steht, ferner 
die Länge dieser Nachricht (höchstens 80 Bytes). 


Diese Angabe ist nur ab DCAM-Version 8.0 ausgewertet (Parameter DCAMVER für den 


ACB). 
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Дд ei (гове өне سے‎ am -ф Register п 


i Nummer des Registers | 
AID (Kennzeichen der DCAM-Anwendung) 


RPB = addr 
YOPNCON RPB 


Adresse des Steuerblocks, 
der den Aufruf beschreibt 


D OPTCD =SPEC 
o АСВ = ге!ехр 


OPTCD = CS 


a ТОМА! = абѕехр (0 5 m < 32767) 


10] AREA = relexp 


AREALN = absexp 


CID (Kennzeichen der Vert 


ARECLN(Länge 


DCAM) ` 
gibt u 
zurück 


CCB 


D abhängig von der maximalen Paketlänge bei Transfer zu einem angeschlossenen Rechner, bzw. von einer Systemkonstanten bei 
Übermittlung innerhalb des Verarbeitungsrechners 
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Beispiele 
Beispiel 1: 


Wenn der Partner mit Namen 'PTN1', der am Prozessor mit Namen "PROZ angeschlossen ist, 
zum Verbindungsaufbau auffordert, soll die Aufforderung angenommen werden. 


YOPNCON RPB=RPBNAM 

RPBNAM YRPB ACB=ACBNAM, 

ССВ-ССВМАМ, | 

ОРТСП-(5РЕС,0) 
АСВМАМ ҮАСВ 20. 
ССВМАМ ҮССВ PTNNAME=PTNAD, 

PRONAME=PROAD 
PTNAD DC CL8’PTNI’ 
PROAD DC CL8’PROZ’ 
Beispiel 2: 


Es soll asynchron, wenn irgendein Partner zum Verbindungsaufbau auffordert, diese Auffor- 
derung angenommen werden. 


ENAEI EINAME=EVENT, 
EIIDRET=IDAD 


YOPNCON RPB=RPBNAM 


SOLSIG EIID=IDAD, 

COND=IMMED 

RPBNAM YRPB ACB=ACBNAM, 
CCB=CCBNAM, 
OPTCD=(ASY,Q), 
EID=IDAD 

ACBNAM YACB er 

CCBNAM YCCB Re 

IDAD DS F 

PTNAD DS CL8 

PROAD DS CL8 
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3.2.1.4 


Aufbau einer Verbindung - Verwendung von Verteilcodes 


Die DCAM-Anwendung muß mit den Attributen SHARE und DISCO eröffnet worden sein 
(siehe 3.1.1.3 und Kapitel 5). Es werden hier nur die Unterschiede zu den vorherigen 
Abschnitten (3.2.1.2 und Kapitel 3) gezeigt; bei beiden Varianten (ACCEPT oder ACQUIRE) 
entfällt die Angabe OPTCD = CS. 


Es kann im CCB angegeben werden: 


13) Die Adresse des Steuerblocks DIP, der die Operanden der Verteilcodes beschreibt. 
Diese Angabe kann entfallen, wenn im CCB bereits ein gültiges Kennzeichen DID steht. 


Im Steuerblock DIP ти% angegeben werden: 
14) die Position des Verteilcodes in der Nachricht 
15) die Länge des Codes, der verwendet wird bzw. der Codes, die verwendet werden. 


17) die Adresse eines oder mehrerer (maximal 16) Steuerblöcke DCG, die eine oder mehrere 
auf dieser Verbindung zulässige Verteilcodes beschreiben. 


Es kann angegeben werden: 
16) das Zeichen, das anzeigt, ob ein impliziter Verteilcode verwendet wird. 
In einem Steuerblock DCG können stehen: 


18) einer oder mehrere Verteilcodes (maximal 8). Die Angabe wird nicht ausgewertet, wenn 
bereits früher ein gültiges Kennzeichen GID eingetragen wurde. | 
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CCB 
СОЙ, DIP und ОСО 
werden nur von 1-12 Š : б 
anderen Steuer- Beschreibung der Verbindung 
blöcken adressiert 
| 13 DIP = relexp 


An- 
gaben 


CODEVAL = | konstante 
X’konstante’ 


C’konstante’ | max. 8 


1) siehe Abschnitt 3.2.1.1. 
2) siehe Abschnitt 3.2.1.2. 
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Beispiel 


Die DCAM-Anwendung heißt ‘APPL’ 


Es soll eine Verbindung mit einem Partner, der den Namen "PARTNER" hat und am Prozessor 


mit dem Namen 'PROZ1' angeschlossen ist, aufgebaut werden. 


Die Verbindung soll die folgenden Eigenschaften haben: 


— Auf dieser Verbindung sollen Nachrichten anhand von Verteilcodes verteilt werden. 


— Der Code besteht aus einem Zeichen (J, K oder L) und befindet sich in der Nachricht an 
dritter Stelle. Ab dem vierten Zeichen folgt Nachrichtentext. 


RPBNAM 


CCBNAM 


ACBNAM 


DIPNAME 


DCGAD 
PTNAD 
PROAD 
DISAD 
APPAD 


YOPNCON 


RPB=RPBNAM 


ACB=ACBNAM, 
CCB=CCBNAM, 
OPTCD=ACQUIRE 
PTNNAME=PTNAD, 
PRONAME=PROAD, 
DIP=DIPNAM 
APPNAME=APPAD, 
DISNAME=DISAD, 
ATTR= (SHARE, DISCO) 
CODEPOS=2, 
CODELN=1, 
DCG=DCGAD 
CODEVAL=(C’J’,C’K’,C’L’) 
CL8’ PARTNER’ 
CL8’PROZ1’ 

CL8’ PRIM’ 

CL8’ APPL’ 
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3.2.1.5 


Anschließen an eine vordefinierte Verbindung 


Dieser Aufruf ist eine Variante der Aufrufe, die in 3.2.1.2 (ohne Verteilcode) und 3.2.1.4 (mit 
Verteilcode) beschrieben wurden. 


Dazu muß angegeben werden: 


1) 


2) 


die Adresse des Steuerblocks ССВ, їп dem die aufzubauende Verbindung beschrieben 
ist; 


OPTCD = ACQUIRE, um sich ап die vordefinierte Verbindung anschließen zu können. 


Weiterhin kann angegeben werden, 


3) 


5) 


б) 


7) 


8) 


Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen der Anwendung (AID) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. Diese Angabe kann entfallen, 
wenn das Kennzeichen vorher (z.B. mit YMODCB) in den RPB eingetragen worden ist. 


daß die Nachrichtenverteilung über die absenderspezifische Warteschlange erfolgen 
soll (CS). Wird nichts angegeben, so wird die empfängerglobale Warteschlange einge- 
stellt (CA). Dies kann bei der Datenübermittlung wieder geändert werden. 


daß der Befehl asynchron ausgeführt werden soll (ASY). Die synchrone Ausführung 
wird eingestellt (SYN), wenn nichts angegeben wird. 


die Adresse eines Feldes von 4 Bytes Länge, in dem das Ereigniskennzeichen steht, 
jedoch nur, wenn der Befehl asynchron ausgeführt werden soll. Dann jedoch darf die 
Angabe nicht entfallen (siehe auch 2.7.2). 


eine Ereignisinformation, die übergeben werden soll, wenn der asynchron ausgeführte 
Befehl beendet wird. Das 1.Byte wird bei der Rückgabe mit X’0C’ überschrieben. 


Fehlt die Angabe, wird keine Information übergeben. 


Im Steuerblock CCB ist die Verbindung zu beschreiben (siehe 3.2.1.1). Es können aber nicht 
alle Optionen angegeben werden (siehe Bild). 


Bei Verwendung von Verteilcodes gilt zusätzlich das in 3.2.1.4 Beschriebene. 
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AID = (register) ` ` 
p= = m u он» un an en =} Register n 


Nummer des Registers 
! AID (Kennzeichen der DCAM-Anwendung) 


RPB = addr 
YOPNCON RPB 


Adresse des Steuerblocks, 
der den Aufruf beschreibt 


ACB = relexp 


OPTCD = CS 
EID = relexp Se 


C’konstante’ 

X’konstante’ 

EIDREF = F’konstante’ 

ана 
V(konstante) 


CID (Kennzeichen der Verbindung) 
USER (Begleitinformation, wie 
sie in USERFLD des CCB 
festgelegt worden ist). 
FDBK (Rückmeldung GC 
siehe Anhang A.2) тоа 
Register 15 (siehe Anhang А.2) 
FDB1 FDB2 | ғовз | FDB4 | 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 


Steuerblock mit aktuellem Kenn- 
zeichen der DCAM-Anwendung (AID) 
13.15 | Angaben zur Verbindung | 


CID (Kennzeichen der Verbindung) | 
| MAXLN (Maximale Länge der аш 
dieser Verbindung 
sendbaren Nachrichten” 
PTNCHA 1 (Die ersten 4 Bytes der 
artnercharakteristika, 
siehe Anhang D) 
EDIT (wie vordefiniert) 
PPROC (APPSTART/ANYSTART) 
wie vordefiniert u 


» abhängig von der maximalen Paketlänge bei Transfer zu einem angeschlossenen Rechner, bzw. von einer Systemkonstanten bei 
Übermittlung innerhalb des Verarbeitungsrechners 


7 


DCAM | 
gibt 
zurück 
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3.2.2 


3.2.2.1 


Abfragen der Einträge über Partner und Verbindungen 


Beim Aufbau einer Verbindung und auch später gibt es unterschiedliche Gründe, über einen 
Partner oder eine Verbindung Informationen abzufragen: 


— Ein Partner, der nicht bekannt ist, fordert zum Verbindungsaufbau auf und schlägt 
Modalitäten vor. Er hat ggf. eine Verbindungsnachricht gesendet. Dies wurde durch den 
Anstoß der LOGON-Contingency-Routine bekannt (REQLOGON). 


— Es wurde keine LOGON-Contingency definiert und darum soll der erste Eintrag einer ggf. 
vorhandenen Warteschlange von Verbindungsaufforderungen geprüft werden (TOPLO- 
GON). 


— Die Charakteristika (siehe Anhang A.4) eines Partners sollen ausgewertet werden 
(РТМСНАВ). 


— Es wird die Anzahl der verbundenen und zur Verbindung auffordernden Partner gebraucht 
(COUNTPTN). 


— Es ist der Partnername und Prozessorname bekannt, es soll aber ein evtl. bereits vorhande- 
nes Kennzeichen der Verbindung (CID) ermittelt werden (NAMXLATE). 


— Es ist das Kennzeichen der Verbindung (CID) bekannt und es sollen der Partnername und 
der Prozessorname ermittelt werden (CIDXLATE). 


Diese unterschiedlichen Abfragen können mit 6 Varianten des Aufrufs YINQUIRE erfolgen. 


Partnerinformation nach einer LOGON-Meldung 


Dazu muß angegeben werden: 
1) Die Adresse eines Bereichs, in den die Verbindungsnachricht geschrieben werden soll. 


2) Die Adresse eines Steuerblocks CCB, in den verschiedene Informationen eingetragen 
werden sollen und in dem die Feldadressen für den Partner- und Prozessornamen 
stehen. 


Ferner kann angegeben werden: 


Ein Register, welches das Kennzeichen LID enthält, das bei Anstoß der LOGON-Contin- 
gency-Routine in Register 4 übergeben wurde. Die Angabe kann nur entfallen, wenn 
vorher (z.B. mit YMODCB) der LID in den RPB eingetragen wurde. 


3) Die Adresse des ACB, der das gültige Kennzeichen AID der Anwendung enthält oder 
ein Register, welches das Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das Kennzeichen in den RPB 
eingetragen worden sein. 


Ein Register, das die Länge der Verbindungsnachricht enthält, wie sie bei Anstoß der 
Contingency in Register 5 übergeben wurde. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) die Länge (höchstens 80 Bytes) іп das 
Feld AAREALN des RPB eingetragen worden sein. 


Hinweis: 


Die Verbindungsnachricht wird abgeschnitten, wenn sie länger ist als der Bereich, dessen 
Länge in AAREALN angegeben wird. Es ist deshalb empfehlenswert, die Länge des Bereichs in 
der Länge der Verbindungsnachricht anzugeben, die in Register 5 bei Anstoß der Contingency 
übergeben wird. 
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AAREALN = (register) 
rar ach um a en ees een vm + Register n 


Nummer des Registers 


Länge der Verbindungsnachricht 


AID = (register) 3 Beer m 
F Nummer des Registers 


AID (Kennzeichen der Anwendung) 


LID = (register 
| го жин E - == a Register o 


Nummer des Registers LID (Kennzeichen der 


, . LOGON-Meldung) 


| АРВ = ачдаг 
YINQUIRE RPB 


Adresse des Steuerblocks, 
der den Aufruf beschreibt 


3 


ACB = геїехр 


ARECLN (Länge der Ver- 
bindungsnachricht) 


FDBK (Rückmeldung 
siehe Anhang A.2) 


Register 15 (siehe Anhang А.2) 


4214, Se Kë ës Verbindungsnachricht 
Steuerblock mit gültigem 
Kennzeichen AID 


CCB 


PTNCHA 1 (die ersten 4 Bytes 
Є der Partner- 
charakteristika, 
siehe Anhang А.4) 


PDEPROT (Datenübermittlungs- DCAM 
rotokoll, wie es vom gibt 
zurück 


artner үч ara db 
wird, siehe Anhang АЛ) 


(Nachrichtenaufbereitung, 
wie sie vom Partner : 


vorgeschlagen wird, | 
siehe Anhang A.1) 
- Name des Partners | 8 Bytes 
(Wenn der Partner mit ` 


der Datenübermittlung 
beginnen will, ist 

der Inhalt: 
PTNSTART. 

Wird keine Angabe 
darüber gemacht, 

ist der Inhalt: 
ANYSTART.) 


Name des Prozessors, 
an dem der Partner 8 Bytes 


angeschlossen ist 
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3.2.2.2 


Beispiel 


Der Benutzer hat eine LOGON-Contingency Routine (Einsprungadresse 'LOGONADR’) defi- 
niert. Wenn sie aktiviert wird, möchte er wissen, wer zum Verbindungsaufbau aufgefordert 


hat. 


Folgende Register werden ihm übergeben: 


In Register 3 AID 
In Register 4 LID 
In Register 5 Länge der Verbinbindungsnachricht 


LOGONADR 
YINQUIRE RPB=RPBCONT, 
AID=(3), 
LID=(4), 
AAREALN=(5) 
RETCO 
RPBCONT YRPB AAREA=BEREICH, 
CCB=CCBCONT 
CCBCONT ` ҮССВ PTNNAME=PTNAME, 
PRONAME=PRNAME 
PTNAME DS С18 
PRNAME DS CL8 , 
BEREICH DS CL80 


Partnerinformation vor dem Verbindungsaufbau 


Dazu muß angegeben werden: 


1) 
2) 


3) 


die Adresse eines Bereichs, in den die Verbindungsnachricht geschrieben werden soll. 


daß Informationen vom ersten der zur Verbindung auffordernden Partner gebraucht 
wird. 


die Adresse eines Steuerblocks CCB, in den verschiedene Informationen eingetragen 
werden sollen und in dem die Feldadressen für Partner- und Prozessornamen stehen. 


Ferner kann angegeben werden: 


4) 


5) 


die Adresse des ACB, der das gültige Kennzeichen der Anwendung (AID) enthält oder 
ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


die Länge des Bereichs, in den DCAM die Verbindungsnachricht einträgt (höchstens 80 
Bytes). Ist die Verbindungsnachricht länger als dieser Bereich, wird sie abgeschnitten 
und in der Rückmeldung eine Warnung ausgegeben. 

Fehlt die Angabe, wird keine Verbindungsnachricht übergeben. 
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AID = (register) 


ps == en = ше s Register п 

{ Nummer des Registers 

! AID (Kennzeichen der Anwendung) 
RPB = addr 


( YINQUIRE RPB 


Adresse des Steuer- 1 
blocks, der den ` 
Aufruf beschreibt. 


H ACB = relexp 
5 AAREALN = value (n < 80) 


ARECLN (Lànge der Ver- x | 
bindungsnachricht) 
FDBK(Rückmeldung, 
siehe Anhang А.2) 


Register 15 (siehe Anhang A.2) 


FDB 1 FDB2 FDB3 FDB 4 
1 Byte 1 Byte 1 Byte 1 Byte 


ОСАМ 
gibt 
zurück 


Verbindungs- 
nachricht 


ACB 
Steuerblock mit gültigem 
Kennzeichen AID 

CCB 


Rückgaben wie bei REQLOGON ') 


DCAM 
gibt 
zurück 


Partnername 
Prozessor- 
name 


8 Bytes 


8 Bytes 


1) siehe Abschnitt 3.2.2.1. 
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3.2.2.3 Partnercharakteristika 


Dazu muß angegeben werden: 


1) die Adresse eines 48 Bytes langen Bereichs, in den die Partnercharakteristika eingetra- 
gen werden sollen (siehe Anhang A.4); 


2) ааб die Partnercharakteristika abgefragt werden sollen. 


Es kann angegeben werden: 
3) die Adresse des Steuerblocks ACB, der das gültige Kennzeichen (AID) enthält oder 
ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


4) Die Adresse des Steuerblocks CCB, der das gültige Kennzeichen der Verbindung enthält 
(CID) oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 
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3.2.2.4 Partneranzahl 


Dazu muß angegeben werden: 


1) Die Adresse eines 8 Bytes langen Bereiches, in den die Information eingetragen wird. 
Sie wird von DCAM in folgender Weise eingetragen: 


Eintrag ist sedezimal 


d d 
Anzahl der Anzahl der zur 
verbundenen Verbindung auf- 
Partner fordernden Partner 


2) daß die Partneranzahl abgefragt werden soll. 


Es kann angegeben werden: 


3) Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen der Anwendung 
enthält (AID) oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das еы Kennzeichen in den RPB 
eingetragen worden sein. 
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AID = (register) 
wir ян нэх авж ны pe +4 Register п 


ummer des Registers 
| AID (Kennzeichen der Anwendung) 


CID = (register) 
үзлээсээ EE Register m 
Nummer des Registers 


CID (Kennzeichen der Verbindung) 
RPB = addr 
YINQUIRE RPB 
Adresse des 
Steuerblocks, 
der den Aufruf 
beschreibt 


ACB = relexp 


FDBK (Rückmeldung 
siehe Anhang A.2) 


DCAM 
gibt 
zurück 


_ Feld für Partner- 
anzahl 


Register 15 (siehe Anhang А.2) 


FDB 1 FDB2 FDB3 FDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


Steuerblock mit 


sen 
Kennzeichen Al 
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3.2.2.5 Kennzeichen der Verbindung (CID) 


Dazu muß angegeben werden: 
1) Die Adresse eines 8 Bytes langen Feldes, іп dem der Partnername steht. 
2) Die Adresse eines 8 Bytes langen Feldes, in dem der Prozessorname des Partners steht. 


3) ааб das Kennzeichen der Verbindung abgefragt werden soll. 


Es kann angegeben werden: 


4) Die Adresse des Steuerblocks АСВ, der das gültige Kennzeichen der Anwendung (AID) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


Hinweis: 


Es können nur Namen von Partnern abgefragt werden, die mit der hier angegebenen 2 
Anwendung, die von diesem Prozeß eröffnet wurde, verbunden sind. 
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AID = (register) 
„>ы а ай нг Register п 


{ Nummer des Registers 
| AID (Kennzeichen der Anwendung) 


RPB = addr 
YINQUIRE RPB 


Adresse des 
Steuerblocks, der 
den Aufruf 
beschreibt 


H ACB = relexp 2 


CID (Kennzeichen . | 
` Verbindung) | . : 


FDBK (Rückmeldung, 
_ „веће sam qa: a 


x DCAM 
x ( gibt 
Register 15 (siehe Anhang A2 x | zurück 


ғов1 | Ервг | FD 
1Byte | 1 Ву 


ACB 


| Steuerblock mit gültigem 
Kennzeichen AID 
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3.2.2.6 Partner- und Prozessornamen 


Dazu muß angegeben werden: 


1) Die Adresse eines 8 Bytes langen Feldes, in das der Partnername geschrieben werden 
soll. 


2) Die Adresse eines 8 Bytes langen Feldes, in das der Prozessornamen des Partners 
eingetragen werden soll. 


3) ааб der Partner- und Prozessornamen abgefragt werden soll. 


Es kann angegeben werden: 


Ein Register, welches das Kennzeichen der Verbindung (CID) enthält. Fehlt die Angabe, 
muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB eingetragen 
worden sein. 


4) Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen der Anwendung (AID) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


"Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den АРВ 
eingetragen worden sein. 


Hinweis: 


Das erste Byte des zurückgegebenen Partnernamens ist ZWR (Zwischenraum), falls das 
angegebene Kennzeichen CID ungültig war. 
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AID = (register) 
p: GE sas a ee шивж ашкы Register п 


Nummer des Registers ` | 
! AID (Kennzeichen der Anwendung) 


CID = (register) 
а, = sch Register m 
; Nummer des Registers 


i 
RPB = addr 


Adresse des Steuer- 
blocks, der den 
Aufruf beschreibt. 


CID (Kennzeichen der Verbindung) 


4 ACB = relexp 
FDBK (Rückmeldung, | 
siehe Anhang A.2) - 


Register 15 (siehe Anhang A.2) | 
FDB 1 FDB2 FDB 3 FDB4 
1 Byte 1 Byte 1 Byte 1 Bytes | 


ACB 


Steuerblock mit gültigem 
Kennzeichen AID 
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3.2.3 Zurückweisen einer Aufforderung zum Verbindungsaufbau 


Dazu muß angegeben werden: 


1) Die Adresse eines 8 Bytes langen Feldes, іп dem der Name des Partners steht, mit dem 
keine Verbindung aufgebaut werden soll. 


2) Die Adresse eines 8 Bytes langen Feldes, in dem der Name des Prozessors des Partners 
steht, mit dem keine Verbindung aufgebaut werden soll. 


Es kann angegeben werden: 


3) Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen der Anwendung (AlD) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 
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AID = (register) 
yes жете me басан wu m “sssi u =Ë Register n 


Nummer des Registers 
| AID (Kennzeichen der Anwendung) 
і 


АРВ = addr 

YREJLOG RPB 
Adresse des Steuer- 
blocks, der den Aufruf 
beschreibt 


‚8 Bytes 


| ACB = relexp 


FDBK (Rückmeldung, 
siehe Anhang A 3 | 


DCAM 
gibt 
zurück 


Steuerblock mit ayaka 
Kennzeichen А! 
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Beispiel 


Eine Aufforderung zum Verbindungsaufbau (gemeldet durch Aktivieren einer LOGON-Contin- 
gency-Routine) vom Kommunikationspartner mit dem Namen PARTNER. дег am Prozessor 
mit dem Namen "PROZ angeschlossen ist, soll zurückgewiesen werden. 


* LOGON-Contingency-Routine 
YINQUIRE _RPB=RPB1, 
AID=(3), 
LID=(4), 


YREJLOG 


RPB1 YRPB 
CCB1 YCCB 
PTNNAM DC 
PRONAM DC 
BEREICH DS 
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AAREALN= (5), 
AAREA=BEREICH 


RPB=RPB1, 
AID=(3), 
AAREA=PTNNAM, 
AREA=PRONAM 
CCB=CCB1 
PRONAME=PRONAM, 
PTNNAME=PTNNAM 
CL8’ PARTNER’ 
CL8’PROZ’ 

С180 


3.2.4 Ändern der Eigenschaften einer Verbindung 


Dazu muß angegeben werden: 


1) Die Adresse des Steuerblocks CCB, der die Verbindung beschreibt, deren Eigenschaf- 
ten geändert werden sollen. 
Die Angabe muß gemacht werden, auch wenn im CCB ein gültiges Kennzeichen der 
Verbindung steht. Enthält der CCB kein gültiges Kennzeichen, muß stattdessen im CCB 
der Name und Prozessorname des Partners angegeben werden. 


Es kann angegeben werden: 
2) Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen (AID) enthält oder 
ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingesetzt worden sein. 


Die Eigenschaften der Verbindung, die geändert werden sollen, sind im Steuerblock CCB zu 
beschreiben. Es werden nur die Felder ausgewertet, die geändert werden können. Welche das 
sind, geht aus der folgenden Übersicht hervor. Näheres ist in der Beschreibung der Eigen- 
schaften einer Verbindung nachzulesen. Die Numerierung der einzelnen Felder bezieht sich 
darauf (siehe 3.2.1.1). 

Wird mit Verteilcodes gearbeitet, können auch neue Steuerblöcke DCG angeschlossen 
werden, eine Änderung der Eintragungen für Codeposition (CODEPOS), Codelänge (CODELN) 
und Codeanzeige (CODEIND) im DIP ist nicht möglich (siehe 3.2.1.4). 
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Makroaufruf 


AID = (register) 


{ Nummer des Registers 


d 
ҮСНАМОЕ 


Adresse des Steuerblocks, 
der den Aufruf beschreibt 


RPB = addr 
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FDB 1 FDB2 FDB3 FDB4 
1 1 Byte 1Byte | 1Byte 1 Byte 


Steuerblöcke und Register 


Register п 


AID (Kennzeichen der Anwendung) 


RPB 


2 АСВ = relexp 


FDBK (Rückmeldung, || 
siehe Anhang A.2) 


Register 15 (siehe Anhang A.2) 


ACB 
Steuerblock mit gültigem 
Kennzeichen AID 


CCB 


C’konstante’ 
X’konstante’ 
F’konstante’ 
A (Konstante) 
V (Konstante) 


PROC = (ТВОМС|КЕЕР) 


4 | PROC = {SYSCODE|BINARY} 
falls EDIT = USER gesetzt wurde 


7ı EDITIN=... 
falls EDIT = SYSTEM gesetzt wurde 
EDITOUT =... 
falls EDIT = SYSTEM gesetzt wurde 
p 


DIP = relex 

falls mit Verteilcodes 
gearbeitet wird und dieser 
Verbindung neue Codes (DCG) 
zugeordnet werden sollen. 


USERFLD = 


PTNNAME = relexp 
PRONAME = relexp 


falls das CID 
im CCB- 
Steuerblock 
ungültig ist. 


DIP 
ОСО = relexp 
DCG 


C’konstante’ тах. 8 
17 | CODEVAL = konstante An- 

X'konstante’ gaben 
GID (Kennzeichen der Мейе- 


codegruppe), wenn nicht 
schon früher eingetragen. 


Speicherbereiche im Benutzerprogramm 


DCAM 
gibt 
zurück 


Partnername 


Prozessorname 


8 Bytes 


8 Bytes 


DCAM 
gibt 
zurück 


Beispiel 


Für die Verbindung, die durch den CCB-Steuerblock mit der Adresse CCB1 beschrieben ist, 
soll die Aufbereitung der Nachrichten bei Eingabe (EDITIN) von PHYS auf LINE gesetzt 


werden. 
YOPNCON RPB=RPB1 
YMODCB BLK=CCB, 
BLKADDR=CCB1, 
EDITIN=LINE 
YCHANGE RPB=RPB1 
ВРВ1 YRPB ACB=ACB1, 
CCB=CCB1 
. weitere Angaben betreffen YOPNCON 
CCB1 YCCB PRONAME=NAM1 , 
PTNNAME=NAM2 
EDIT=SYSTEM, 
EDITIN=PHYS 
ACB1 ` YACB 
3.2.5 Rücknahme einer Aufforderung 


Dazu kann angegeben werden: 


1) Die Adresse des Steuerblocks ACB, der das gültige Kennzeichen der Anwendung KÉN 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


Es muß angegeben werden: 


2) Die Adresse des Steuerblocks CCB, der Adressen von Feldern mit Partner- und 
Prozessornamen enthält. Wartet eine Verbindungsaufforderung zu dem dort adressier- 
ten Partner auf seine Annahme, wird sie gelöscht. 
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AID = (register) 


жаза сор men wm ЭЭ Register п 


Nummer des Registers 
AID (Kennzeichen der Anwendung) 


RPB = addr 
YCLSCON RPB 


Adresse des Steuerblocks, ACB = relexp 


der den Aufruf beschreibt 
FDBK (Rückmeldung, . 
siehe Anhang А.2) 


Beispiel 


SCH 


ОСАМ 
gibt 
zurück 


Register 15 (siehe Anhang A.2) 


FDB 1 FDB2 FDB3 FDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 


Steuerblock mit тен 
Кеппгеісһеп А! 


Der Verbindungswunsch, der an einen im Steuerblock ССВ ап Adresse ССВМАМ adressierten 
Partner gerichtet war, soll aufgehoben werden. 


çS YCLSCON RPB=RPBNAM 
RPBNAM YRPB CCB=CCBNAM 
CCBNAM YCCB PTNNAME=PTNAD, 
PRONAME=PROAD 
PTNAD DC CL8’ РАВТ1' 
PROAD DC CL8’ PROZO” 
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3.2.6 Abbau einer Verbindung 


Dazu kann angegeben werden: 


1) Die Adresse des Steuerblocks АСВ, der das gültige Kennzeichen der Anwendung (AID) 
enthält oder | 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


2) Die Adresse des Steuerblocks CCB, der das gültige Kennzeichen der Verbindung (CID) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm ә 


AID = (register) | 
ame єн Guss ve 66; Register п 


| Nummer des Registers 
AID (Kennzeichen der Anwendung) 


| 
i CID = (register) 

GES әне sns GED ant Guss Register m 
Шаа 


ummer des Registers 
| CID (Kennzeichen der Verbindung) 
RPB = addr 
YCLSCON RPB 


Adresse des Steuer- | 
blocks, der den Ë ACB = relexp 
” ССВ = ге!ехр 


Aufruf beschreibt 
FDBK (Rückmeldung, 
siehe Anhang A.2) 


Register 15 (siehe Anhang A.2) 
FDB 1 FDB2 FDB3 FDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


CCB 


Steuerblock mit кеп 
Kennzeichen С! 


АСВ 


Steuerblock mit Кете" 
Kennzeichen А! 
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Beispiel 


© Die Verbindung, deren Kennzeichen CID in Register 3 steht, soll abgebaut werden. 


CLSCON RPB=RPBNAM ‚CID=(3) 


RPBNAM YRPB 


3.3 Auf die Datenübermittlung bezogene Makroaufrufe 


Nach erfolgtem Verbindungsaufbau können Kommunikationspartner Daten übermitteln. 

Ein Sende- bzw. Empfangsaufruf bedeutet immer Übernahme der Daten aus dem Benutzerbe- 
reich in den Datenspeicher des Kommunikationssystems bzw. umgekehrt. So wird beispiels- 
weise ein Sendeaufruf in dem Moment erfolgreich beendet, in dem die zu sendenden Daten in 
den Datenspeicher des Kommunikationssystems übertragen worden sind. 


S Der Benutzer kann ferner mit einem kombinierten Sende- und Empfangsaufruf eine Unterbre- 
chung des Programmablaufs sparen. 


Die Verteilcodezuordnung wird mit 2 Aufrufen gesteuert. 
Makroaufrufe, die auf die Datenübermittlung bezogen sind: 
— YSEND Senden einer Nachricht 

YRECEIVE Empfangen einer Nachricht 


— YSENDREC Senden einer Nachricht und darauffolgender Empfang einer Nach- 
richt von demselben Partner 


— YRESET Zurücknehmen von YRECEIVE-Aufrufen und Ändern des CS/CA- 
Zustands der Verbindung. 


— YPERMIT Einem Prozeß der Prozeßgruppe den Empfang von Nachrichten mit 
bestimmten Verteilcodes ermöglichen 
— YFORBID Einem Prozeß der Prozeßgruppe den Empfang von Nachrichten mit 
bestimmten Verteilcodes verbieten. 
© DCAM-Prozesse können die asynchronen Meldungen 
— EXPR Expreßnachricht angekommen 
— TACK Transportquittung angekommen 


— Erfolgter Empfang einer Nachricht 


in einer entsprechenden Contingency-Routine bearbeiten (siehe 2.7.2 und 2.8). 
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3.3.1 


Senden einer Nachricht 


Dazu muß angegeben werden: 


1) 


Die Adresse des Feldes, das die zusendenden Daten enthält. 


Ferner kann angegeben werden: 


2) 


3) 


4) 


5) 


б) 


7) 


8) 
9) 


10) 
11) 


12) 


Die Länge der Nachricht, die gesendet werden soll. 


Die Angabe kann entfallen, wenn eine Expreßnachricht gesendet werden soll. In diesem 
Fall wird die maximale Länge von 8 Bytes angenommen. 


Die Adresse des ACB-Steuerblocks, in dem das gültige Kennzeichen der Anwendung 
(AID) steht oder ein Register, in dem das gültige Kennzeichen steht. Fehlt die Angabe, 
muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB eingetragen 
worden sein. 


Die Adresse des CCB-Steuerblocks, in dem das gültige Kennzeichen der Verbindung 
(CID) steht oder ein Register, in dem das gültige Kennzeichen steht. Fehlt die Angabe, 
muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB eingetragen 
worden sein. 


daß die Nachricht per Expreß übermittelt werden soll (d.h. unter Umgehung aller 
Datenflußkontrollen und mit der Fähigkeit, andere Nachrichten für den gleichen Partner 
zu überholen). Diese Angabe schließt ein, daß die Länge maximal 8 Bytes betragen 
kann. Bei Normalnachrichten entfällt diese Angabe. 


Bei Strukturierung der Nachricht: Welcher Teil der Nachricht übermittelt werden soll. 
Hier kann ELEMENT oder SUBGROUP angegeben werden. Fehlt die Angabe, wird 
GROUP angenommen. Die Angabe ist nur möglich, wenn im CCB für EDIT=USER oder 
EDIT=SYSTEM mit EDITOUT=PHYS festgelegt wurde. 


Eine Laufnummer der Nachricht, die vom Benutzer festgelegt wird. Diese Angabe ist 
erforderlich, wenn eine Transportquittung angefordert wird. Wird sie weggelassen, wird 
die Nummer "0” eingetragen. 


daß eine Transportquittung für diese hier gesendete Nachricht angefordert wird. 


daß nach Ausführung dieses Aufrufs die Nachrichten, die von diesem Partner kommen, 
in die absenderspezifische (CS) Warteschlange eingetragen werden sollen. Fehlt die 
Angabe, wird die empfängerglobale Warteschlange (CA) eingestellt. 


Die Angabe (CS) muß gemacht werden, wenn CS vorher eingestellt wurde und 
Empfangsaufrufe (YRECEIVE z.B.) bereits abgegeben wurden, die noch nicht beendet 
sind. 


Die Angabe (CS) kann nicht mehrmals gemacht werden: Wurde sie bereits in einem 
anderen Aufruf (z.B. YRECEIVE) gegeben, der CS-Zustand ist aber noch nicht eingestellt 
worden (asynchrone Ausführung), kann sie hier nicht nochmals erfolgen. 


Die Angabe (CS) ist nur sinnvoll, wenn ohne Verteilcodes gearbeitet wird (ATTR=NS- 
HARE oder (SHARE,NDISCO) beim YOPEN angegeben). 


Angabe, daß die Nachricht mit akustischem Alarm an der Datenstation verbunden 
werden soll; wird nur ausgewertet, wenn EDIT=SYSTEM. 


Die Adresse des Feldes, in dem das Ereigniskennzeichen für Go-Signale steht, jedoch 
nur, wenn die Verbindung mit PROC=SIGNAL aufgebaut wurde. 


Eine Ereignisformation, die übergeben werden soll, wenn das GO-Signal eingetroffen 
ist. Diese Angabe ist jedoch nur erforderlich bei PROC=SIGNAL. Das erste Byte wird 
bei der Rückgabe mit ХОС” überschrieben. 


Siehe Hinweise 4.22. 
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AID = (register) 
an С» um um Register n 
Nummer des Registers í 


AID (Kennzeichen der Anwendung) 


CID = (register) 


EE анты» сын) ӘРИ 
i 
! 
1 
1 
i 
i 
! 

+ 
2) 
Ф 
© 
21 
Ф 
3 


CID (Kennzeichen der Verbindung) 


! 
ВРВ -- адаг 
YSEND RPB 


Adresse des Steuer- 
blocks, der den 
Aufruf beschreibt 


n Bytes 


ACB = relexp 
CCB = relexp 


OPTCD = EXPRESS 


ELEMENT 


OPTCD = ) SUBGROUP 


7 | SEQNO = absexp (0 < n < 65535) 


OPTCD = TACK 
OPTCD = CS 


OPTCD = BELL 
Ereignis- 


C’konstante’ 
X’konstante’ 
EIDREF =< F’konstante’ 
A(konstante) 
V(konstante) 


DCAM 
gibt 
zurück 


Steuerblock mit gültigen 
Kennzeichen CI 
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3.3.2 


Beispiel 


Es soll eine Normalnachricht mit der laufenden Nummer 15 (enthalten in Register 5) auf der 
Verbindung, die durch den CCB-Steuerblock mit der Adresse CCBAD beschrieben ist, 
abgeschickt werden. Der Nachrichtentext sei ‘HALLO PARTNER’. 


YSEND RPB=RPBAD, 
SEQNO= (5) 
RPBAD YRPB ACB=ACBAD, 
CCB=CCBAD, 
AREA=TEXT, 
AREALN=13 
ACBAD YACB “4 
ССВАП ҮССВ е, 
ТЕХТ 0С C’HALLO PARTNER’ 


Empfangen einer Nachricht oder Transportquittung 


Dazu muß angegeben werden: 


1) Die Adresse des Bereichs, der die Daten aufnehmen soll, ferner die Länge dieses 
Bereichs, die mindestens 8 Bytes umfassen muß. 


Ferner kann angegeben werden: 


2) Die Adresse des Steuerblocks ACB, in dem das gültige Kennzeichen der Anwendung 
(AID) steht oder ein Register, in dem das gültige Kennzeichen steht. Fehlt die Angabe, 
muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB eingetragen 
worden sein. 


3) Die Adresse des Steuerblocks CCB, in dem das gültige Kennzeichen der Verbindung 
(CID) steht oder ein Register, in dem das gültige Kennzeichen steht. Fehlt die Angabe, 
muß vorher (z.B. mit YMODCB) das gültige Kennzeichen іп den АРВ eingetragen 
worden sein. Die Angabe kann weggelassen werden, wenn die Nachricht eines beliebi- 
gen Partners (ANY) empfangen werden soll. 


4) daß die Nachricht eines bestimmten Partners (SPEC) empfangen werden soll. 


Die Angabe kann nicht gemacht werden, wenn die absenderspezifische Warteschlange 
eingestellt war (CS) und bereits ein YRECEIVE oder YSENDREC mit SPEC und Umschal- 
tung auf die empfängerglobale Warteschlange (CA) gegeben wurde, der noch nicht 
beendet ist. 


Die Angabe darf nicht gemacht werden, wenn die empfängerglobale Warteschlange 
eingestellt ist. 


Fehlt diese Angabe, wird die Nachricht eines beliebigen Partners empfangen (ANY). 


5) daß nach Ausführung dieses Aufrufs die Nachrichten, die von diesem Partner kommen, 
in die absenderspezifische Warteschlange (CS) eingetragen werden sollen. 


Fehlt die Angabe, wird die empfängerglobale Warteschlange (CA) eingestellt. 


Wird mit dem YRECEIVE eine Transportquittung empfangen, wird dieser Operand nicht 
ausgewertet. 


Die Angabe wird nur ausgewertet, wenn ohne Verteilcodes gearbeitet wird (ATTR=NS- 
HARE oder (SHARE, NDISCO) beim YOPEN angegeben). 
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AID = (register) omm eme erma omə 2) Register n 
Nummer des Registers = 
š ы | AID (Kennzeichen der Anwendung) 
| Giel, ой -x = -ф Register m 


i Nummer des Registers ; , 
i CID (Kennzeichen der Verbindung) 
| “ВРВ = addr 
YRECEIVE RPB 


Adresse des Steuer- 
blocks, der den 
Aufruf beschreibt 


n Bytes 


2| Ар өр 
el шй ыш. у. у. 

ИИҮҮ шт 
те | oro e 


18: ЖАУДЫ = use (0< n < 32767) 
Ereignis- x 


C’konstante’ 
X’konstante’ 
EIDREF = { F’konstante’ 


wl 


ee 


V 


FDBK (Rückmeldung, 
siehe Anhang A.2) 


konstante 


CID (Kennzeichen der Verbindung) 
jedoch nur, wenn von einem 
beliebigen Partner (ANY) 


ARECLN (Länge der empfangenen 
Nachricht); (Länge des 
zu langen Teils, wenn 
Nachricht länger als in 
AAREALN angegeben) 


ASEQNO (Laufnummer It. SEQNO 
des Partners DCAM- 
Anwendung oder wie im 
Datenkommunikations- 
system vergeben, wenn 
der Partner eine Daten- 

station ist) 


TACKNO (Laufnummer der 
“ди Шепеп Nachricht, 
wenn eine Transport- 
quittung empfangen 
wurde) 


DCAM 
gibt 
zurück 


(Begleitinformation, wie 
in USERFLD des ССВ fest- 
gelegt); jedoch nur, wenn 
von einem beliebigen 
Partner (ANY) 


Register 15 (siehe Anhang A.2) 


FDB 1 FDB2 FDB 3 FDB 4 
1 Byte 1 Byte 1 Byte 1 Byte 


CCB 


Steuerblock mit gültigen 
Kennzeichen С! 


© 
W зе un EE 


ACB 


Steuerblock mit кеп 
Kennzeichen А! 
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б) 


7) 


8) 


9) 


10) 


11) 


wie die zu langen Nachrichten (länger als in AAREALN angegeben) zu behandeln sind: 
Entweder, daß sie abgeschnitten und der zu lange Teil weggeworfen wird (TRUNC) oder 
daß der zu lange Teil für einen weiteren YRECEIVE aufgehoben wird (KEEP). 


Fehlt diese Angabe, wird das angenommen, was beim Aufbau der Verbindung festge- 
legt wurde (CCBTK; siehe 3.2.1.1). 


Bedingung für die Ausführung von KEEP ist, daß spätestens hier die absenderspezifi- 
sche Warteschlange (CS) eingestellt wird. 


daß der Aufruf, falls er nicht sofort bearbeitet werden kann, nicht beendet wird (О). 


Fehlt die Angabe, wird er sofort beendet, ggf. mit Fehlermeldung. Er wird dann 
sozusagen nur auf Verdacht gegeben und nicht in eine Warteschlange eingetragen 
(NO). 


Die Angabe muß gemacht werden, wenn der Befehl asynchron ausgeführt werden soll. 


Die maximale Verweilzeit (TOVAL), die der YRECEIVE in der Warteschlange bleiben soll. 
Nach Ablauf dieser Zeit, wenn die gewünschten Daten nicht eingetroffen sind, wird der 
Aufruf beendet. 


Wird keine Angabe gemacht, wird eine Zeit von 600 Sekunden eingestellt. Die Angabe 
U bedeutet Festlegung einer unbegrenzten Wartezeit. 


Die Angabe wird nicht ausgewertet, wenn kein Eintrag in die Warteschlange vorgese- 
hen ist (МО). 


daß der Befehl asynchron ausgeführt werden soll (ASY). Fehlt die Angabe, wird er 
synchron ausgeführt (SYN). 


Die Adresse des Feldes, in dem das Ereigniskennzeichen steht, jedoch nur, wenn der 
Befehl asynchron ausgeführt werden soll. Dann jedoch kann die Angabe nicht entfallen 
(siehe 2.7.2). 


Eine Ereignisinformation, die übergeben werden soll, wenn der asynchron ausgeführte 
Befehl abgeschlossen wurde. Das erste Byte wird bei der Rückgabe mit X’0C’ über- 
schrieben. 


Fehlt die Angabe, wird keine Information übergeben. 


Hinweis: 


Auf YSEND kann bei EDIT=SYSTEM eine negative, zweite Transportquittung eintreffen. Sie 
geht bei SHARE-Anwendungen unabhängig von ВЕОТАФК an den Primärprozeß. 
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Beispiele: 
6 Beispiel 1: (synchrone Verarbeitung) 


Es soll auf der durch den CCB-Steuerblock (mit der Adresse CCBAD) beschriebenen Verbin- 
dung eine Nachricht empfangen werden, die maximal 100 Bytes lang ist. Falls doch eine 
längere Nachricht ankommt, so soll der zu lange Teil aufgehoben werden. Die Nachricht soll in 
den Bereich an der Adresse 'EMPFANG' geschrieben werden. 


YRECEIVE _ ВРВ—=ВРВАП 
YRECEIVE | RPB=RPBAD 


RPBAD YRPB ACB=ACBAD, 
CCB=CCBAD, 
AAREA=EMPFANG, 
AAREALN=100, 
OPTCD=(KEEP,CS) 

ACBAD YACB ei 

CCBAD YCCB SES 

. EMPFANG DS CL100 


Beispiel 2: (asynchrone Verarbeitung) 


Es soll auf der durch den CCB-Steuerblock (mit der Adresse CCBAD) beschriebenen Verbin- 
dung asynchron eine Nachricht empfangen werden, die maximal 100 Bytes lang ist. Falls doch 
eine längere Nachricht ankommt, soll der zu lange Teil weggeworfen werden. Die Nachricht 
soll in den Bereich mit der Adresse 'EMPFANG' geschrieben werden. 


ENAEI EINAME=EVENT, 
EIIDRET-IDAD 


YRECEIVE | RPB=RPBNAM 


SOLSIG EIID=IDAD, 
COND=IMMED 
RPBNAM YRPB ACB=ACBNAM, 
ç CCB=CCBAD, 
AAREA=EMPFANG, 
AAREALN=100, 
OPTCD=(TRUNC,ASY,0), 
EID=IDAD 
ACBNAM YACB 
CCBAD YCCB SC 
EMPFANG DS CL100 
IDAD DS F 
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3.3.3 


Senden und Empfangen kombiniert 


Dazu muß angegeben werden: 
1) Die Adresse des Feldes, das die zu sendenden Daten enthält. 


2) Die Adresse des Feldes, das die zu empfangenden Daten aufnehmen soll, ferner die 
Länge des Feldes, die mindestens 8 Bytes betragen muß. 


Der Aufruf kann nicht gegeben werden, wenn die empfängerspezifische Warteschlange 
(CS) zwar eingestellt war, aber bereits ein anderer YRECEIVE oder YSENDREC die 
Umschaltung auf die empfängerglobale Warteschlange (CA) gefordert hat, dessen 
Befehl aber noch nicht ausgeführt ist. Grundsätzlich ist der Aufruf nicht möglich, wenn 
die empfängerglobale Warteschlange eingestellt ist. 


Ferner kann angegeben werden: 


Die Angaben des YSEND und YRECEIVE, soweit sie erforderlich sind (siehe 3.3.1 und 
3.3.2). Die Felder sind mit 'S' für YSEND und 'R' für YRECEIVE gekennzeichnet. Die 
Beschreibung der einzelnen Operanden ist bei den jeweiligen Einzelaufrufen zu fihden. 


Beispiel 


In einem Programm wurde eine Schleife angelegt, die solange durchlaufen wird, bis ein 
bestimmtes Ereignis eingetreten ist. Danach soll das Programm an der Adresse fortgesetzt 
werden, die in Register 3 geladen wurde. In der Schleife wird bei jedem Durchlauf eine 
Nachricht ausgegeben, deren Länge in Register 6 steht. 


Es wird auf eine Nachricht von der gleichen Länge maximal 3 Minuten gewartet. Bevor die 
Schleife angesprungen wird, wird in Register 5 das Kennzeichen der Verbindung geladen, die 
bedient werden soll. Während der Schleifendurchläufe soll immer die gleiche Verbindung 
bedient werden. Zu lange Nachrichten werden nicht berücksichtigt. Transportquittungen 
werden nicht verarbeitet. Der Aufruf soll synchron verarbeitet werden. Da nur eine Anwen- 
dung in dem Programm eröffnet wurde und immer mit dem gleichen RPB-Steuerblock 
gearbeitet wird, wurde zu Anfang das Kennzeichen der Anwendung [AID) dort eingetragen. 


SCHLEIFE YSENDREC RPB=RPBADDR, 
CID=(5), 
AREA=SENDETXT, 
AREALN=(6), 
AAREA=EMPFTEXT, 
AAREALN=(6), 
OPTCD=(SPEC,CS,Q,TRUNC) , 
TOVAL=180 
Ereignis eingetreten? 
wenn ja: BR 3 
wenn nein: B SCHLEIFE 
RPBADDR YRPB 
SENDETXT DS OF 
EMPFTEXT EQU ж 
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AID = (register) | 


p m — — — — шин — шиэ vm Register n 


Nummer des Registers AID (Kennzeichen der Anwendung) 


1 

| CID = (register 

i л сф Register m 
: Nummer des Registers 


RPB = addr 
YSENDREC RPB 
Adresse des Steuer- 


blocks, der den 
Aufruf beschreibt 


CID (Kennzeichen der Verbindung) 


n Bytes 


n Bytes 


Sj АСВ = relexp 
CCB = relexp 
OPTCD = EXPRESS 
VEN 
| OPTCD= (SUBGROUP) 
SEQNO = absexp (0 < n < 65535 
OPTCD = TACK 


OPTCD = CS 


RUN 


 —— w ям w w 


| сох {соо о 
BSBBBBBBE 


A 
d 
= 
х 
2 
3 
d 
d 
J 
23 
d 
Я 
3 
A 


8R| TOVAL = absexp (0< m < 32767) 


Ereigniskenn- 
zeichen 4 Bytes 


C’konstante’ 
X’konstante’ 
EIDREF = + F’konstante’ 
А ийг 
V (konstante) 


| | FDBK (Rückmeldung, siehe AnhangA 2) 
weitere Rückmeldungen siehe 
YRECEIVE (Abschnitt 3.3.2) 


Register 15 (siehe Anhang A.2) 


I FBB1 | ғов2 | FDB3 | PDB4 
1 Byte 1 Byte 1 Byte 1 Byte 


DCAM 
gibt 
zurück 


CCB 
Steuerblock mit “қалай 


Kennzeichen СІ 


АСВ 


Steuerblock mit gültigem 
Kennzeichen AID 
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3.3.4 


Zurücknehmen von Empfangsaufrufen und Ändern des CS/CA-Zustands 


Dazu muß angegeben werden: 


1) 


Die Adresse des Steuerblocks АСВ, in dem das gültige Kennzeichen der Anwendung 
(AID) steht oder | 


ein Register, in dem das gültige Kennzeichen steht. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen in den RPB 
eingetragen worden sein. 


Ferner kann angegeben werden: 


2) 


3) 


4) 


Die Adresse des Steuerblocks CCB, in dem das gültige Kennzeichen der Verbindung 
(CID) steht oder 


ein Register, in dem das gültige Kennzeichen steht. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das gültige Kennzeichen der Verbin- 
dung in den RPB eingetragen worden sein. 


Die Angabe kann weggelassen werden, wenn 3) nicht angegeben ist. 


daß alle anstehenden YRECEIVE SPEC-Aufrufe der im CCB gekennzeichneten Verbin- 
dung zurückgenommen werden sollen. Fehlt die Angabe, werden alle anstehenden 
YRECEIVE ANY-Aufrufe dieses Prozesses innerhalb der im ACB genannten Anwendung 
zurückgenommen. 


daß nach der Ausführung eines YRESET SPEC-Aufrufs Nachrichten von dieser Verbin- 
dung in die absenderspezifische Warteschlange eingetragen werden sollen. Bedingung: 
Es wird ohne Verteilcodes gearbeitet (ATTR=NDISCO) beim YOPEN im ACB und 
OPTCD=SPEC іп 3). 


DCAM V8.0A DCAM Makroaufrufe, 0987-.)-275-2 


Ç Makroaufruf Steuerblëcke und Register Spei 


AID = (Register) _ билээ eme бай мешел =& Register n 


AID (Kennzeichen der Anwendung) 
CID = (Register) 


| 
| 
| regen 
| 


| CID (Kennzeichen der Verbindung) 


RPB = add 
YRESET Sien RPB 


Adresse des 
Steuerblocks, 
der den Aufruf 
beschreibt 


CCB = relexp 
OPTCD = SPEC 


OPTCD = CS 


FDBK (Rückmeldung siehe Anhang A.2) 


Register 15 (siehe Anhang А.2) 


FDB1 FDB2 FDB3 FDB4 
1BYTE 1BYTE 1ВҮТЕ | 1ВҮТЕ 


DCAM 
gibt 
zurück 


Steuerblock mit gültigem Kennzeichen AID 
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3.3.5 


3.3.5.1 


Steuerung der Verteilcode-Zuordnung 


Für die Steuerung der Verteilcodezuordnung stehen dem Primärprozeß zwei Aufrufe zur 
Verfügung. Mit dem einen kann er eine Zuordnung von Verteilungsnamen und Verteilcode- 
Gruppenblock (DCG) herstellen oder einen Verteilcode-Gruppenblock modifizieren (YPER- 
MIT), mit dem zweiten löst er diese Zuordnung wieder auf (YFORBID), ohne eine neue 
Zuordnung zu treffen. 


Zuordnen eines Verteilungsnamens zu einem Verteilcode-Gruppenblock 


Dazu muß angegeben werden: 


1) Die Adresse des Feldes, in dem der Verteilungsnamen steht, der beim YOPEN festgelegt 
wurde. 


2) Die Adresse des Verteilcode-Gruppenblocks (DCG), der zugeordnet oder modifiziert 
werden soll. 


Es kann angegeben werden: 


3) Die Adresse des ACB-Steuerblocks, der das gültige Kennzeichen der Anwendung (AlD) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß das Kennzeichen vorher (z.B. mit YMODCB) in den RPB-Steuer- 
block eingetragen worden sein. 


Beispiel 


In einer DCAM-Anwendung soll der Prozeß, der beim Eröffnen den Verteilungsnamen ‘BETA’ 
angegeben hat, Nachrichten über die Verteilcodes erhalten, die im Verteilcode-Gruppenblock 
(DCG) an der Adresse 'DCGAD' beschrieben sind. 


YPERMIT RPB=RPBAD 


RPBAD YRPB ACB=ACBAD, 
AREA=DISNAM2, 
AAREA=DCGAD 
ACBAD YACB 
DCGAD YDCG Эс (Beschreibung wie z.B. beim 
YOPNCON festgelegt) 
DISNAM2 DC CL8’BETA’ 
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Makroaufruf Steuerblöcke und Register Speicherbereiche іт Benutzerprogramm | 


AID = (register 
Pm ЫН Register n 


! Nummer des Registers 
ї AID (Kennzeichen der Anwendung) 


RPB = адаг 
YPERMIT RPB 


Adresse des Steuerblocks, 
der den Aufruf beschreibt 


8 Bytes 


В АСВ = relexp 
FDBK ( Rückmeldefeld, 
siehe Anhang A.2) 


Register 15 (siehe Anhang A.2) 


FDB 1 РОЗ? 1 FDBS FDB 4 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 


DCAM 
gibt 
zurück 


Steuerblock mit Кече 
Kennzeichen А! 


DCG 


C’konstante’ 
CODEVAL = < konstante 
X’konstante’ 
max. 8 Angaben 


GID (Kennzeichen des DCG), 
wenn nicht schon früher 
eingetragen 
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3.3.5.2 Auflösen der Zuordnung 


Dazu muß angegeben werden: 


1) Die Adresse des Feldes, in dem der Verteilungsname steht, für den die Zuordnung 
aufgehoben werden soll. 


Es kann angegeben werden: 


2) Die Adresse des ACB-Steuerblocks, der das gültige Kennzeichen der Anwendung (AID) 
enthält oder 


ein Register, welches das gültige Kennzeichen enthält. 


Fehlt die Angabe, muß vorher (z.B. mit YMODCB) das Kennzeichen in den RPB 
eingetragen worden sein. 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


AID = (register) 


po = = =m am am = 


Register n 
ummer des Registers + 2 
AID (Kennzeichen der Anwendung) 


RPB = addr 
YFORBID RPB 


Adresse des Steuer- 
FDBK (Rückmeldung siehe Anhang A.2) 


blocks, der den 
Aufruf beschreibt 
Register 15 (siehe Anhang A.2) 
FDB 1 FDB2 FDB 3 FDB 4 
1 Byte 1 Byte 1 Byte 1 Byte 


ACB 


8 Bytes 


Steuerblock mit қынай 
Кеппгеісһеп А! 
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Beispiel 


Die Zuordnung von Verteilungsname "ALPHA und dem dazugehörigen DCG-Steuerblock soll 
aufgelöst werden. 


YFORBID RPB=RPBAD 


RPBAD YRPB АСВ-АСВАП, 
AREA=DISNAM 
ACBAD YACB хий 
DISNAM DC CL8’ ALPHA’ 
3.4 Auf die Namen-Zuweisung bezogene Makroaufrufe 


Um Programme unabhängig von aktuellen Operandenwerten zu machen, kann der Benutzer 
die Namen-Zuweisungsfunktion anwenden. 


Zur Erstellung von Einträgen in die prozeßspezifische Tabelle CLT (communication link table) 
stehen zwei Makroaufrufe zur Verfügung: 


— YAPPL für Einträge, die die DCAM-Anwendung betreffen 
— YCONN für Einträge, die die logische Verbindung betreffen. 
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3.4.1 Zuweisung für die DCAM-Anwendung 
Es muß angegeben werden: 
1) Im ACB ein Kettungsname (weitere Einträge siehe Beschreibung des YOPEN, 3.1.1) 


Es kann angegeben werden: 


2) daß die Informationen der CLT-Einträge die Angaben im ACB überschreiben. Fehlt die 
Angabe, stehen sie nur während des Aufrufs zur Verfügung. 


Ferner müssen 


3) Eintragungen in der CLT gemacht werden, wahlweise durch den Makro YAPPL (Erläute- 
rungen siehe Beschreibung des YOPEN, 3.1.1) oder mit 
/APPLICATION-Kommando (siehe Anhang A.8). 


Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


ACB = relexp 
YOPEN ACB 


bi LINKMOD.= PERM 


СТ | ; 


3 | Eintragunqen It. YAPPL-Makro oder /APPL-Kommando ” : 


YAPPL 


Verteilungsname 


C’konstante’ 


USEPASS = 4 X’konstante’ Kennwort für Sekun- 
(register) 


därprozeß, Vorgabe 
im Primärprozeß 
C’konstante’ 
USEPW = X'konstante’ Келу 
(register) Sekundärprozeß 
C’konstante’ 
LOGPASS = 4 X’konstante’ Kennwort für log. 
(register) V 


erb., Vorgabe 
: im Primärprozeß 


` siehe [6] 
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Beispiel 


© Das Kennwort für logische Verbindungen soll in einem eigenen Programm, bevor das 
eigentliche DCAM-Programm gestartet wird, jeweils aktualisiert werden. Die Eingabe erfolgt 
über SYSIPT. 


Vorlaufprogramm: 


AKTUELL START 
* Lesen der Information von SYSIPT: ES 


RDCRD PASSW, STADR 


x Eintrag in die CLT: 


STADR LA 6, PASSW 
YAPPL LINK=LINKNAME, 
LOGPASS=(6) 


PASSW DS ОЕ 


© DS 80C 


DCAM-Verarbeitungsprogramm: 


YOPEN ACB=ACBAD 
ACBAD YACB LOGPASS=C'UNDF', 
LINK=LINKAD 
LINKAD DC C” LINKNAME ’ 
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3.4.2 


Zuweisung für die logische Verbindung 


Es muß angegeben werden: 


1) Im CCB ein Kettungsname (weitere Einträge siehe Beschreibung des ҮОРМСОМ, 3.2.1 
bis Kapitel 5). 


Es kann angegeben werden: 


2) daß die Informationen der CLT-Einträge die Angaben im CCB überschreiben sollen. 
Fehlt die Angabe, stehen sie nur während des Aufrufs zur Verfügung. 


Ferner müssen: 


3) Eintragungen in der CLT gemacht werden, wahlweise durch den Makro YCONN (Erläu- 
terungen der einzelnen Einträge siehe Beschreibung des YOPNCON, 3.2.1 bis Kapitel 5) 
oder mit /CONNECTION-Kommando (siehe Anhang A.8). 


Beispiel 


Das Kennwort für logische Verbindungen soll vom auffordernden Prozeß für jede Sitzung neu 
angegeben werden. Ein Vorlaufprogramm übernimmt das aktuelle Kennwort von einer 
Lochkarte (SYSIPT). 


Vorlaufprogramm: 


AKTUELL START 


* Lesen der Inforkätion von SYSIPT: 


RDCRD PASSW, 5ТАПН 


* Eintrag in die CLT: 


STADR LA 6 PASSW 
YCONN LINK=LINKNAME, 
LOGPW=(6) 
PASSW DS ОЕ 
0$ 80C 


DCAM-Verarbeitungsprogramm: 


YOPNCON RPB=RPBAD 
RPBAD YRPB CCB=CCBAD, 
OPTCD=ACQUIRE, ... 
CCBAD YCCB LOGPW=C’UNDF’, 
LINK=LINKAD, ... 
LINKAD DC C’ LINKNAME’ 
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© Makroaufruf Steuerblöcke und Register Speicherbereiche im Benutzerprogramm 


RPB = relexp 
YOPNCON RPB 


CCB = relexp 
B 


CC 


8 Bytes 


Eintragungen D YCONN-Makro oder /CONN-Kommando 


| partnername 
d (register) kationspartners 
теме ша” 


Kommunikationspartn 


C’konstante’ 
USERFLD =  X’konstante’ 


Feld für Benutzer- 
information 


(register) 


"Kennwort zum Aufbau 


C’konstante’ 
LOGPW = X’konstante’ 
einer log. Verbindung 


(register) 
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Бэ МӨН 
Ee eo 
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4 Katalog der Makroaufrufe 


In diesem Kapitel sind die Makroaufrufe an DCAM mit den formalen Einzelheiten aufgeführt. 


In Tabelle 4-1 wird ein Überblick über die beschriebenen Aufrufe gegeben mit ihrer Zuordnung 
zu den Funktionen von DCAM und einer kurzen Beschreibung. 


Die Makroaufrufe sind in diesem Kapitel ohne Rücksicht auf ihre Funktion alphabetisch 
geordnet, um ein leichteres Auffinden zu ermöglichen. 


Sie werden nach dem folgenden Schema beschrieben: 


Name Operation Operanden 


symbolischer Name | Makroaufruf schlüsselwort=parameter,.... 


— Die Reihenfolge der Schlüsselwortparameter ist beliebig. 
— Іп eckigen Klammern |)! stehende Operanden sind frei wählbar. 


— Geschweifte Klammern “||” enthalten alternative Angaben, die untereinander geschrie- 
ben sind. 


— Ein unterstrichener Operand ‘LOGON’ wird bei Nichtangabe dieses Operands gesetzt 
(Standardwert). 


— Runde Klammern '()' enthalten eine Operanden-Unterliste eines oder mehrerer durch 
Kommata getrennter Operanden. Die runde Klammer kann wegfallen, wenn die Unterliste 
aus nur einem Орегапаеп besteht. Die Länge der Unterliste darf inklusive der Klammern 
und Kommata 127 Zeichen nicht überschreiten. 


— Drei Punkte nach einem Komma bedeuten, daß der davor stehende Operand mehrfach 
wiederholt werden kann: "schlüsselwort = neuer wert,.... 


— Mnemotechnische Werte (Merknamen, die in mehreren Aufrufen verwendet werden): 


Für die folgenden mnemotechnischen Werte gelten dieselben Konventionen, wie sie für 
die 'Makroaufrufe des Ablaufteils’ festgelegt sind (Anhang A.5): 


— relexp 

— absexp 

— value (=Registerangabe oder absexp) 
- адаг (=Registerangabe oder геїехр) 
— character 

— symbol 

— integer 

— code 

— (register) 


Für ‘(register)’ ist die Nummer eines Mehrzweckregisters in runden Klammern anzugeben. 
Alle weiteren Werte werden, da sie nur einmal vorkommen, beim jeweiligen Aufruf 
erläutert. 
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Makroaufruf 
YACB 


YAPPL 


YCCB 


YCHANGE 


YCLOSE 


YCLSCON 


YCONN 


YDCG 


YDIP 


YENB 


YFORBID 


YGENCB 


YINQUIRE 


YMODCB 
YOPEN 
YOPNCON 


YPERMIT 


YRECEIVE 


YREJLOG 


Funktion 


Namen- 
Zuweisung 


Verbindung 


Verbindung 


Existenz 
Verbindung 


Namen- 
Zuweisung 


Datenüber- 
mittlung 


Existenz 
Verbindung 


Existenz 
Verbindung 


Datenüber- 
mittlung 


Datenüber- 
mittlung 


Verbindung 


Beschreibung 
Erzeugen eines Anwendungssteuerblocks 


Speichern von Angaben zur DCAM-Anwendung in der 
CLT und auch Löschen dieser Angaben 


Erzeugen eines Verbindungssteuerblocks 


Ändern von Eigenschaften einer bereits aufgebau- 


ten Verbindung 
Schließen einer DCAM-Anwendung 


Rücknahme einer Aufforderung oder Abbau einer 
logischen Verbindung 


Speichern von Angaben zur Verbindung in der CLT 
und auch Löschen dieser Angaben 


Erzeugen eines Verteilcode-Gruppenblocks 
Erzeugen eines Verteilungsparameterblocks 
Erzeugen eines Ereignis-Meldungsblocks, der 
asynchrone Meldungen mit Contingency-Routinen 


verknüpft 


Aufhebung einer Zuordnung des Verteilungsnamens 
zu einer Verteilcodegruppe 


Erzeugen eines oder mehrerer Steuerblöcke einer 
beliebigen Art 


Abfrage von Informationen über Anwendungen und 
logische Verbindungen 


Ändern von Feldern in bestehenden Steuerblöcken 
Eröffnen einer DCAM-Anwendung 
Aufbau einer logischen Verbindung 


Zuordnung des Verteilungsnamens zu einer 
Verteilcodegruppe 


Empfang einer Nachricht, Expreßnachricht 
oder Transportquittung 


Zurückweisen einer Aufforderung 
zum Verbindungsaufbau 
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Makroaufruf 


YRESET 


YRPB 


YSEND 


YSENDREC 


YSETLOG 


YSHOWCB 


YTESTCB 


Tabelle 4-1 


Funktion 


Daterüber- 
mittlung 


Datenüber- 
mittlung 


Datenüber- 


mittlung 


Existenz 


Makroaufrufe 
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Beschreibung 


Zurücknehmen von Empfangs-Aufrufen und Ändern 
des CS/CA-Zustands einer Verbindung 


Erzeugen eines Anforderungsparameter-Blocks 
Senden einer Nachricht oder Expreßnachricht 
Kombiniertes Senden einer Nachricht oder Expreß- 
nachricht und Empfangen einer Nachricht, Expreß- 
nachricht oder Transportquittung 


Ändern des Zustands einer Anwendung 


Übertragen einzelner Feldinhalte aus einem 
Steuerblock in den Benutzerbereich 


Vergleichen eines Feldinhalts in einem Steuerblock 
mit einem vorgegebenen Wert 


ҮАСВ 


4.1 YACB 


Funktion 


Es wird ein Anwendungssteuerblock (ACB = application control block) erzeugt (siehe auch 
211217 


Format 


Name Operation Operanden 


[symbol] | YACB [, АРРМАМЕ=ге1ехр | 


$НАВЕ DISCO 
e ний! 


[,ATTR=( ` ) 
PRIMTASK LOGON 
[,{REQTASK ||, ] 

NOTACK NLOGON 
|,015МАМЕ-ге1ехр | 
[, РАОМАМЕ-ге1ехр | 
(,ЕМВ-ге1ехр | 
[,LINK=relexp] 
PERM 
[ , LINKMOD= | 
ТЕМР 
[, LOGPASS=kennwort1] 
[,USEPASS=kennwort2] 
[,USEPW=kennwort3] 
NO 
(,МЕНІҒҮ-4 PRIMARY || 
SECONDARY 


[ , DCAMVER=absexp | 


Operanden 

APPNAME=relexp 

Adresse des Feldes, in dem der Name der DCAM-Anwendung steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN durch einen Primärprozeß. Der Operand ist wahlweise für ATTR=NSHARE. Ist 
kein Name angegeben, so wird im Verarbeitungsrechner, in dem der YOPEN aufrufende 
Prozeß existiert, ein eindeutiger Name erzeugt, den der Benutzer jedoch nicht in Erfahrung 
bringen kann. 


— ҮОРЕМ durch einen Sekundärprozeß. 
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ҮАСВ 


Der Bereich, auf den durch diesen Operanden verwiesen wird, muß die folgenden Bedingun- 


© gen erfüllen: 


.— Der Bereich muß еіп 8 Byte langes Feld sein. 


— Der Name muß alphanumerisch und linksbündig ausgerichtet sein, das erste Byte muß 
alphabetisch sein (A-Z, e +, $). Das heißt, der Name muß den Konventionen für 
Assembler-Namen entsprechen. 


- '$' іт 1. Byte ist für System-Anwendungen reserviert. 


— Nichtgenutzte Bytes des Feldes müssen mit Leerzeichen (Х'40') aufgefüllt sein. 


PRONAME=relexp 


Adresse eines 8 Bytes langen Feldes, in das DCAM den symbolischen Namen des eigenen 
Prozessors einträgt. Fehlt die Angabe, wird der Name nicht zurückgegeben. Dieser Operand 
wird von DCAM ausgewertet bei: 


— YOPEN 


Є фт | 
АТТВ= 


NSHARE 
Die DCAM-Anwendung kann entweder von 
SHARE mehreren Prozessen benutzt werden (mehrfach benutzbar) oder von 
NSHARE einem einzigen Prozeß (einfach benutzbar). 
Dieser Operand wird von DCAM ausgewertet bei: 
— ҮОРЕМ durch einen Primärprozeß 


— ҮОРЕМ durch einen Sekundärprozeß. Die Angabe von ATTR = SHARE ist hier obligato- 
risch. Ist SHARE nicht angegeben, wird der YOPEN-Aufruf nicht ausgeführt und es wird 
eine entsprechende Rückmeldung (siehe Anhang А.2) erzeugt. 


DISCO 
ATTR= 
NDISCO 
© DISCO Die Verteilung von Nachrichten an einen bestimmten Prozeß der DCAM- 
Anwendung wird anhand eines Verteilcodes in der Nachricht vorgenom- 
men. Diese Angabe ist nur sinnvoll, wenn ATTR=SHARE gesetzt wurde. 
NDISCO Es wird die Standard-Nachrichtenverteilung verwendet (über empfänger- 


globale und absenderspezifische Warteschlangen). 
Dieser Operand wird von DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß. 
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ҮАСВ 


PRIMTASK 
ATTR=+ REOTASK 
NOTACK 
Die Quittung über einen Nachrichtentransport wird 
PRIMTASK an den Primärprozeß geleitet. 
ВЕОТА5К an den eine Quittung anfordernden Prozeß geleitet. Diese Angabe ist nur 
sinnvoll bei ATTR= SHARE. 
NOTACK nicht weitergeleitet und vernichtet, auch wenn im YSEND- bzw. 
YSENDREC-Aufruf (OPTCD=TACK) eine positive Quittung angefordert 
wird. 


Dieser Operand wird von DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß. 


LOGON 
ATTR= 
NLOGON 
Aufforderungen zum Verbindungsaufbau werden grundsätzlich 
LOGON bearbeitet. 
NLOGON nicht bearbeitet. 


Dieser Operand wird von DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß. 


DISNAME=relexp 

Adresse des Feldes, in dem der Verteilungsname steht. 

Dieser Operand wird ausgewertet bei: 

— ҮОРЕМ durch einen Primärprozeß, wenn ATTR=(SHARE,DISCO) gesetzt wurde. 


— YOPEN durch einen Sekundärprozeß, wenn der Primärprozeß den Operanden ATTR=- 
(SHARE,DISCO) angegeben hat. 


Es können höchstens 8 Prozesse denselben Verteilungsnamen angeben. 


Der Bereich, auf den durch diesen Operanden verwiesen wird, muß die folgenden Bedingun- 
gen erfüllen: 


— DerBereich muß ein 8 Byte langes Feld sein. 


— Der Name muß alphanumerisch und linksbündig ausgerichtet sein, das erste Byte muß 
alphabetisch sein (A-Z, @, #, $). Das heißt, der Name muß den Konventionen für 
Assembler-Namen entsprechen. 


- Nicht genutzte Bytes des Feldes müssen mit Leerzeichen (Х'40') aufgefüllt sein. 
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ҮАСВ 


ЕМВ=ге1ехр 


Ç Adresse des Ereignis-Meldungsblocks (ENB). Sie verbindet den ACB-Steuerblock mit dem 
ENB-Steuerblock. Der ENB-Steuerblock enthàlt die Adressen der Kennzeichen der Contingen- 
cy-Routinen, die zum Ablauf gebracht werden sollen, wenn bestimmte Ereignisse gemeldet 
werden [siehe 2.8 und 4.10). 


Es kann in mehreren ACB-Steuerblöcken auf denselben ENB-Steuerblock verwiesen werden. 
Dieser Operand wird von DCAM ausgewertet bei: 

— YOPEN durch einen Primärprozeß 

— ҮОРЕМ durch einen Sekundärprozeß. 


LINK=relexp 

Adresse des Feldes in dem der Kettungsnamen steht (siehe auch 4.2). 
Dieser Operand wird von DCAM ausgewertet bei: 

— YOPEN durch einen Primärprozeß 

— YOPEN durch einen Sekundärprozeß. 


ç Der Bereich, auf den durch diesen Operanden verwiesen wird, muß die folgenden Bedingun- 
gen erfüllen: 


— Der Bereich muß ein 8 Byte langes Feld sein. 
— Die Zeichen müssen linksbündig ausgerichtet sein. 


— Der Name muß alphanumerisch und linksbündig ausgerichtet sein, das erste Byte muß 
alphabetisch sein (A-Z, @, #, $). Das heißt, der Name muß den Konventionen für 
Assembler-Namen entsprechen. 


- 9 im 1. Byte ist für System-Anwendungen reserviert. 


— Nichtgenutze Bytes des Feldes müssen mit Leerzeichen (X’40’) aufgefüllt sein. 


PERM 
LINKMOD= 


TEMP 


PERM Die Angaben im ACB sollen von den Informationen des CLT-Eintrags 
© überschrieben werden, der durch den Kettungsnamen identifiziert wird. 


Der Benutzer muß ein Feld für einen Anwendungsnamen angeben. DCAM 
schreibt den tatsächlichen Anwendungsnamen bei YOPEN in dieses Feld. 


TEMP Die Informationen des CLT-Eintrags stehen nur während des Aufrufs zur 
Verfügung. Die Angaben im ACB werden nicht verändert. 


Dieser Operand wird von DCAM ausgewertet bei 


— YOPEN 
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LOGPASS=kennwor t1 
Vorgabe eines Kennworts zum Aufbau einer Verbindung. 


Funktion des Kennworts: Bei jeder Aufforderung zum Verbindungsaufbau, die an diese 
DCAM-Anwendung gerichtet wird, ти% der auffordernde Partner das Kennwort angeben 
(LOGPW im CCB-Steuerblock). 


Dieses Kennwort kann während einer bestehenden Anwendung nicht geändert werden. Wenn 
bei vorhandener Kennwort-Vorgabe der auffordernde Partner oder der Benutzer der Daten- 
station kein oder ein falsches Kennwort angibt, so weist DCAM die Aufforderung zum 
Verbindungsaufbau zurück. Der auffordernde Prozeß wird durch die Rückmeldung von der 
Zurückweisung benachrichtigt (siehe Anhang A.2). 


Dieser Operand wird von DCAM nur ausgewertet bei: 
— YOPEN durch einen Primärprozeß, wenn im ACB ATTR = LOGON gesetzt wurde. 


kennwort1 kann als Zeichenkonstante: C’konstante’ oder Sedezimalkonstante: 
Х'копѕїапїе' in der Länge von 4 Bytes angegeben werden. Der Standard- 
wert ist: Х”00000000”, gleichbedeutend mit "kein Kennwort vorgegeben’. 


USEPASS=kennwort2 
Vorgabe eines Kennworts zum Anschluß von Sekundärprozessen. 


Funktion des Kennworts: Jeder Sekundärprozeß muß bei der Eröffnung der DCAM-Anwen- 
dung dieses Kennwort angeben (USEPW im ACB-Steuerblock). Wenn bei vorhandener 
Kennwortvorgabe ein Sekundärprozeß beim Eröffnen der DCAM-Anwendung kein oder ein 
falsches Kennwort angibt, so weist DCAM den entsprechenden Makroaufruf (YOPEN) zurück. 
Der Sekundärprozeß wird durch die Rückmeldung von der Zurückweisung benachrichtigt 
(siehe Anhang А.2). 


Dieses Kennwort zu vergeben ist nicht sinnvoll, wenn die Anwendung in der Netzdatei RDF 
bereits geschützt ist. Wird es dennoch vergeben, so ist es gleich dem Kennwort in der RDF zu 
setzen. Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN durch einen Primärprozeß, jedoch nur, wenn ATTR=SHARE gesetzt wurde. 


kennwort2 kann als Zeichenkonstante: C’konstante’ oder Sedezimalkonstante: 
X’konstante’ in der Länge von 4 Bytes angegeben werden. 


Der Standardwert ist: X’00000000’, gleichbedeutend mit ‘kein Kennwort 
vorgegeben’. 


USEPW=kennwort3 
Angabe des Kennworts zum Anschluß an eine mehrfach benutzbare DCAM-Anwendung. 


Funktion des Kennworts: Dieses Kennwort wurde von dem Primärprozeß unter dem Operan- 
den USEPASS vorgegeben oder es existiert ein RDF-Kennwort. Jeder weitere diese DCAM- 
Anwendung eröffnender Sekundärprozeß muß dieses Kennwort unter dem Орегапдеп 
USEPW angeben. Wenn ein RDF-Kennwort vorhanden ist, muß es auch vom Primärprozeß 
angegeben werden. 


Dieser Operand wird von DCAM nur ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß 
USEPW muß das RDF-Kennwort enthalten (falls vorhanden) 


— ҮОРЕМ durch einen Sekundärprozeß 
USEPW muß das RDF-Kennwort (falls vorhanden) bzw. das vom Primärprozeß mit 
USEPASS angegebene Kennwort (falls vorhanden) enthalten. 
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Hinweis: 


USEPASS und USEPW erhalten die analoge Bedeutung im YAPPL-Makro bzw. im 
APPLICATION-Kommando. 


kennwort 3 kann als Zeichenkonstante: C’konstante’ oder Sedezimalkonstante: 
A konstante іп der Länge von 4 Bytes angegeben werden. 


Der Standardwert ist: Х'00000000', gleichbedeutend mit "kein Kennwort 
angegeben’. 


NO 
МЕВТЕҮ-4 PRIMARY 
SECONDARY 


Der die DCAM-Anwendung eröffnende Prozeß will: 
NO irgendein Prozeß sein. 
PRIMARY ersteröffnender Prozeß sein. 
SECONDARY nachfolgender Prozeß sein. 
Dieser Operand wird von DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß 
— ҮОРЕМ durch einen Sekundärprozeß 


Wird die hier gesetzte Bedingung nicht erfüllt, wird der Makroaufruf nicht ausgeführt. Der 
Benutzer erhält die entsprechende Rückmeldung (siehe Anhang А.2). 


DCAMVER = absexp 
Angabe der DCAM-Versionsnummer. 


Dieser Operand stellt sicher, daß ein Programm hinsichtlich der neu hinzugekommenen 
Funktionen einer DCAM-Version kompatibel ist. 


Wird dieser Operand nicht angegeben so wird als Default-Wert eine DCAM-Version < 7.0 
angenommen. 


8.0 muß angegeben werden, wenn das Programm die folgenden neuen Funk- 
tionen der DCAM-Version 8.0 verwendet. 


— Übermittlung einer Verbindungsnachricht bei YOPNCON mit OPTCD=ACCEPT. 
— Angabe der maximalen Nachrichtenlänge durch MAXLN-Parameter bei YOPNCON. 


Sekundärprozesse müssen eine Anwendung mit der gleichen DCAMVER eröffnen wie der 
Primärprozeß. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN 
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4.2 


YAPPL 


Funktion 


Der Makroaufruf YAPPL wird verwendet, um in der prozeßspezifischen Tabelle CLT (commu- 
nication link table) Angaben über eine DCAM-Anwendung zu speichern oder zu löschen. 


Dieser Makro wendet die Namen-Zuweisungsfunktion an (siehe 3.4). 


Format 
Name Operanden 
[symbol] | YAPPL anwendungsname 
(register) 
kettungsname 
‚LINK= 
(register) 
verteilungsname 
[ , DISNAME= 
(register) 
kennwort1 
|, USEPASS= 
(register) 
kennwort2 
[ , USEPW= 
(register) 
kennwort3 
[ , LOGPASS= 
(register) 
Operanden 
anwendungsname 
(register) 


anwendungsname gibt den Namen der DCAM-Anwendung ап. 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A Ze +, 
$), d.h., der Name muß den Konventionen für Assembler-Namen entspre- 
chen. '$’ als erstes Zeichen ist für Systemanwendungen reserviert, z. В. 
$TSOS. 


(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Anwendungs- 


name linksbündig steht. Nach rechts sind freie Bytes mit ZWR (Х'40') 
aufzufüllen. 
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kettungsname 
ә (register) 

kettungsname gibt den Kettungsnamen an. 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A-Z, @, %, 
$), d.h., der Name muß den Konventionen für Assembler-Namen entspre- 
chen. 

(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Kettungsname 
linksbündig steht. Nach rechts sind freie Bytes mit ZWR (Х'40') aufzufül- 
len. 


Wenn dieser Operand alleine angegeben ist, werden frühere Eintragungen der CLT unter 
gleichem Kettungsnamen gelöscht. 


verteilungsname 
DISNAME= 


(register) 


verteilungsname 
© gibt den Namen an, unter dem diesem Prozeß eine Verteilcodegruppe 
zugeordnet werden kann. 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A-Z, @, #, 
$), d.h., der Name muß den Konventionen für Assembler-Namen entspre- 
chen. 


(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Verteilungs- 
name linksbündig steht. Nach rechts sind freie Bytes mit ZWR (X’40') 
aufzufüllen. 


kennwort]1 
USEPASS= 


(register) 


kennwort1 ein Primärprozeß definiert hiermit das Kennwort für den Anschluß eines 
Sekundärprozesses an die Anwendung (siehe auch Makroaufruf YACB). 
Das Kennwort ist 4 Bytes lang und ist eine Zeichenkonstante: C’konstante’ 
oder eine Sedezimalkonstante: X’konstante‘. | 


© (register) enthält die Adresse einer 4 Bytes langen Adreßkonstanten, in der das 
Kennwort rechtsbündig steht. 


kennwort2 
USEPW= 


(register) 


kennwort2 gibt das Kennwort für den Anschluß eines Sekundärprozesses an eine 
Anwendung an, gegeben im Sekundärprozeß oder das RDF-Kennwort 
(siehe auch Makro YACB). 


Das Kennwort ist 4 Bytes lang und ist eine Zeichenkonstante: C’konstante’ 
oder eine Sedezimalkonstante: X’konstante'. 


(register) enthält die Adresse einer 4 Bytes langen Adreßkonstanten, in der das 
Kennwort rechtsbündig steht. 
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kennwort3 
LOGPASS= 


(register) 


kennwort3 gibt das Kennwort zum Aufbau einer Verbindung an, gegeben im Primär- 
prozeß als Vorgabe für die Kommunikationspartner. Das Kennwort ist 4 
Byte lang und ist eine Zeichenkonstante: C’konstante’ oder eine Sedezi- 
malkonstante: AS konstante, 
Dieses Kennwort kann während einer bestehenden Anwendung nicht 
geändert werden. 


(register) enthält die Adresse einer 4 Byte langen Adreßkonstanten, in der das 
Kennwort rechtsbündig steht. 


Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register |Rückinformation Bedingung 

15 Der Aufruf wurde wie 
links- gewünscht ausgeführt. 
bündig 


Der angegebene Kettungsname 
wurde nicht verwendet. 


Der Aufruf konnte wegen eines 
Systemfehlers nicht ausgeführt 
werden. 


Der Aufruf wurde nicht 
ausgeführt, weil nicht 
genug Speicherplatz vor- 
handen war. 
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4.3 ҮССВ 


Funktion 


Es wird ein Verbindungssteuerblock (CCB = connection control block) erzeugt (siehe auch 


32:7). 

Format 

Name Operanden 
[symbol] | YCCB [PTNNAME=relexp] 


[,PRONAME=relexp] 
[ DEPROT=USER] 


|, 01Р-ге1ехр | 


USER 
© Ee | 


SYSTEM 
PHYS GETBS GETFC LCASE 
штеп | | 1 h 1 d 
FORM NGETBS NGETFC NLCASE 
PHYS HCOPY HOM EXTEND LOGC LACK 
БД 1 I 1 | 1 | 1 Ach 
FORM NHCOPY NHOM NEXTEND NLOGC NLACK 


[‚LINK=relexp] 
PERM 

[ , LINKMOD= ] 
TEN 

|, LOGPW=kennwort4] 


TRUNC) [SYSCODE] [АРРЅТАКТ) [NSIGNAL 
те d d d d 
KEEP | (BINARY | [ANYSTART| SIGNAL 


[,USERFLD=benutzerfeld] 


| МАХШ-арвехр | 


Operanden 

PTNNAME=relexp 

Adresse des Feldes, im dem der Name des Kommunikationspartners steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON, wenn іт RPB-Steuerblock OPTCD = ACQUIRE oder OPTCD = (ACCEPT, 
SPEC) gesetzt wurde. Bei YOPNCON тії OPTCD = (ACCEPT,ANY) trägt ОСАМ den Namen 
in das Feld ein. 


— YINQUIRE, wenn im RPB-Steuerblock OPTCD=REQLOGON oder =TOPLOGON gesetzt 
wurde. DCAM trägt den Namen in das Feld ein. Wird bei YINQUIRE REQLOGON keine 
Aufforderung gefunden, trägt DCAM im ersten Byte Х'00' ein. 
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— YCHANGE, wenn im CCB-Steuerblock das Kennzeichen CID ungültig ist bzw. der CCB- 
Steuerblock DCAM noch nicht bekannt ist. 


Der Bereich, auf den durch diesen Operanden verwiesen wird, muß die folgenden Bedingun- 
gen erfüllen: 


— Der Bereich muß ein 8 Byte langes Feld sein. 


— Der Name muß alphanumerisch und linksbündig ausgerichtet sein, das erste Byte muß 
alphabetisch sein (A-Z, @, #, $). Das heißt, der Name muß den Konventionen für 
Assembler-Namen entsprechen. 


- Nicht genutzte Bytes des Feldes müssen mit Leerzeichen (Х'40') aufgefüllt sein. 


PRONAME=relexp 
Adresse des Feldes, in dem der Prozessorname des Kommunikationspartners steht. 


Es ist im gleichen Format wie PTNNAME anzugeben. Erstes Zeichen Х'40' bedeutet "eigener 
Prozessor” bei YOPNCON ACQUIRE Aufrufen. 


DEPROT=USER 


USER Auf dieser Verbindung wird eine private Vereinbarung für die Steuerung der 
Datenübermittlung benutzt (Datenübermittlungsprotokoll). 


DIP=relexp 
Adresse des DIP-Steuerblocks. Er enthält: 


— Die Lage und Länge des Verteilcodes in der Nachricht, die auf der durch diesen CCB- 
Steuerblock beschriebenen Verbindung übermittelt wird. 


— Die Adresse des DCG-Steuerblocks. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON und 
— YCHANGE, jedoch nur, wenn mit Nachrichtenverteilung anhand von Verteilcodes gearbei- 
tet wird. 


USER 
EDIT= 


SYSTEM 


USER Die Nachrichtenaufbereitung bei Ein- oder Ausgabe wird vom Benutzer 
selbst durchgeführt. Es werden keine Logischen Datenstationen benutzt. 


Falls auch der Operand PROC=SYSCODE gesetzt ist, wird die Nachricht in 
EBCDIC übersetzt. 


Hinweis: 


Nicht bei lokal angeschlossenen Datenstationen. 
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SYSTEM Das Kommunikationssystem führt die Nachrichtenaufbereitung nach Maß- 
gabe der in diesem Steuerblock gesetzten EDITIN- bzw. EDITOUT-Operan- 
ç den durch. 


Voraussetzung ist, daß die Nachricht in EBCDIC vorliegt. 


Diese Angabe ist die Voraussetzung für die Benutzung logischer Datensta- 
tionen. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON 


PHYS 
EDITIN=; LINE 
FORM 


Dieser Operand legt die Nachrichtenaufbereitung bei der Eingabe fest. 


PHYS Das System beschränkt die Nachrichtenaufbereitung auf eine evtl. notwen- 
dige Entblockung und evtl. auf Übergabe von Kleinbuchstaben. Dabei wird 
vom System eine Reassemblierung geblockter Nachrichten unterstützt und 

© ggf. Kleinbuchstaben übergeben. 


LINE Das System bereitet Nachrichten mit Hilfe von logischen Datenstationen 
auf. 


Hinweis: 


Die logischen Steuerzeichen können mit symbolischen Namen angegeben 
werden (siehe Anhang A.13). 


FORM Die Nachrichtenaufbereitung wird vom Systemprogramm ‘FHS’ oder 
‘FORM’ durchgeführt (Format-Datenstation). 


Diese Operanden werden von DCAM ausgewertet bei: 


— YOPNCON, 
— YCHANGE, 
jedoch nur, wenn auch EDIT=SYSTEM gesetzt wurde. 
GETBS 
EDITIN= 
NGETBS 
GETBS Der Benutzer behandelt das Zeichen 'Rückwärtsschritt’ (backspace charac- 
ç ter, X'16') selbst. 
NGETBS Das System entfernt alle Zeichen 'Rückwärtsschritt’ und die dadurch zu 


löschenden Zeichen. 
Der Operand wird von DCAM ausgewertet bei: 


— YOPNCON, 
— ҮСНАМСЕ, 


jedoch nur, wenn EDIT=SYSTEM gesetzt wurde. 


Die Funktion ist nur sinnvoll bei einer Schreibstation, die 'Rückwärtsschritt’” (backspace) 
verwendet, z.B. Schreibstation 8103. 
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бЕТЕС 
EDITIN= 


NGETFC 
Der logische Funktionstastencode, der von der Datenstation gesendet wird, 
GETFC wird als erstes Zeichen der Nachricht übertragen 


NGETFC wird nicht übertragen. (Für die Werte des Funktionstastencodes siehe 
Anhang A.10). 


Der Operand wird von DCAM ausgewertet bei: 


— YOPNCON 
— YCHANGE, 


jedoch nur, wenn EDIT=SYSTEM und EDITIN=LINE gesetzt wurde. 


LCASE 
EDITIN= 
NLCASE 
LCASE Der Benutzer behandelt Kleinbuchstaben selbst. 
NLCASE Das System übersetzt Kleinbuchstaben in Großbuchstaben. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON, 
— YCHANGE, 


jedoch nur, wenn EDIT=SYSTEM gesetzt wurde. 


PHYS 
EDITOUT=} LINE 
FORM 


Dieser Operand legt die Nachrichtenaufbereitung bei der Ausgabe fest. 


PHYS Das System führt keine Nachrichtenaufbereitung durch, bis auf die Über- 
gabe von Kleinbuchstaben. 

LINE Das System bereitet Nachrichten mit Hilfe von logischen Datenstationen 
auf. 
Hinweis: 


Die logischen Steuerzeichen sollten mit symbolischen Namen angegeben 
werden (siehe Anhang А. 13). 
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FORM Die Nachrichtenaufbereitung wird vom Systemprogramm ‘FHS’ oder 
© 'FORM'’ durchgeführt (Format-Datenstation). 

Dieser Operand wird von DCAM ausgewertet bei: 

— YOPNCON, 

— YCHANGE, 


jedoch nur, wenn EDIT=SYSTEM gesetzt wurde. 


HCOPY 
EDITOUT= 
NHCOPY 
HCOPY Die auszugebende Nachricht wird bei Datensichtstationen zusätzlich auf 
einem Drucker ausgegeben (hardcopy), wenn ein solches Gerät vorhanden 
und betriebsbereit ist. 
NHCOPY Es findet keine zusätzliche Ausgabe auf einem Drucker statt (hardcopy). 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON, 
© — YCHANGE, 


jedoch nur, wenn EDIT=SYSTEM gesetzt wurde. 


Er findet nur Anwendung bei EDITOUT=LINE oder =PHYS beim Einsatz von Datenstationen 
des Typs 8151, 8152, 816X und 9750. 


HOM 
EDITOUT= 


NHOM 
Die Strukturierung der Nachricht wird festgelegt. 


HOM Die Nachricht soll unstrukturiert ausgegeben werden, d.h., alle logischen 
Zeilen einer Nachricht werden als Einheit behandelt. 


NHOM Die Nachricht wird strukturiert ausgegeben, d.h. jede einzelne logische 
Zeile der Nachricht ist eine Einheit. 


Dieser Operand wird von DCAM ausgewertet bei 


© — ҮОРМСОМ, 
— YCHANGE, 


jedoch nur, wenn EDIT=SYSTEM und EDITOUT=LINE gesetzt wurde. 


EXTEND 
EDITOUT= 


NEXTEND 
EXTEND Die Ausgabedaten sind durch das System geschützt. 
NEXTEND Die Ausgabedaten sind nicht geschützt. 


Dieser Operand findet nur Anwendung, wenn EDITOUT=LINE gesetzt wurde und beim 
Einsatz von Datenstationen des Typs 975X und 816Х. 


Mit Ausnahme von BELL, LCASE und GETFC werden keine EDIT-Funktionen berücksichtigt. 
Auf der Tastatur sind die Tasten RUN, EFZ, AFZ und LSP gesperrt. 
Das Kontrollzeichen NL in der Eingabe ist bei EXTEND nicht erlaubt (FDBK 04 00 48). 
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Wenn YSEND тїї EXTEND benutzt wird, setzt DCAM automatisch EDITOUT=EXTEND beim 
nächsten YRECEIVE. 


Dieser Operand wird ausgewertet bei: 


— YSEND 
LOGC 
EDITOUT= 
NLOGC 
LOGC Alle logischen Steuerzeichen einer Nachricht werden ausgewertet und in 
Gerätesteuerzeichen umgesetzt (Drucker-Unterstützung). 
Spezielle physikalische Steuerzeichen werden ausgewertet (s. Anhang 
A.13). Andere Zeichen < X'40' werden durch SUB (Schmierzeichen) 
ersetzt. 
NLOGC Es werden keine logischen Steuerzeichen ausgewertet. Alle Zeichen, die im 


EBCDIC-Code < Х'40' sind, werden durch SUB (Schmierzeichen) ersetzt. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YSEND 


LACK 
EDITOUT= 


NLACK 
Es werden logische Quittungen von der Druckerstation angefordert. 
LACK Es werden positive und negative logische Quittungen angefordert. 


Der Operand OPTCD=TACK wird nicht tangiert, d.h. es kommen ggf. 
logische Quittungen und Transportquittungen an. 


Das Steuerblockfeld SEQNO іт RPB wird als Bezugsfeld für logische 
Quittungen und für Transportquittungen verwendet. Dabei müssen die 
beiden Bytes der SEQNO im ASCI-Code umsetzbar sein und für jedes der 
beiden Bytes muß gelten 20 < 5ЕОМО < 7Ғ (z.B. die abdruckbaren 
Zeichen). 


NLACK Weder positive noch negative logische Quittungen kommen an. 


Postive und negative Transportquittungen kommen entsprechend dem 
Anforderungskennzeichen im RPB ап (ТАСК/МАСК). 


Dieser Operand findet nur Anwendung bei EDITOUT=LINE. 


Logische Quittungen können über den Makroaufruf YRECEIVE wie normale Meldungen 
empfangen werden. 


Aufbau einer logischen Quittung: 


Byte 0: Logische Information 
Byte 1-2: Bezugsfeld: SEQNR 
Byte 3: Information über Drucker-Status 


Dieser Operand wird von DCAM ausgewertet bei: 


— YSEND 
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LINK=relexp 

© Adresse eines Feldes in dem der Kettungsname steht (siehe auch 4.7 
Dieser Operand wird von DCAM ausgewertet bei: 
— YOPNCON 


Der Bereich auf den durch diesen Operanden verwiesen wird, muß die folgenden Bedingun- 
gen erfüllen: 


— Der Bereich muß ein 8 Byte langes Feld sein. 

- Die Zeichen müssen linksbündig ausgerichtet sein. 

— Das erste Zeichen muß alphabetisch sein (A-Z, е, # , $). 

— Nicht genutzte Bytes des Feldes müssen mit Leerzeichen (Х'40') aufgefüllt sein. 


PERM 
LINKMOD= 


TEMP 


PERM Die Angaben im CCB sollen von den Informationen des CLT-Eintrags 
überschrieben werden, der durch den Kettungsnamen identifiziert wird. 


S TEMP Die Informationen des CLT-Eintrags stehen nur während des Aufrufs zur 
Verfügung. Die Angaben im CCB werden nicht verändert. 


Dieser Operand wird von DCAM ausgewertet bei 
- YOPNCON 


jedoch nur, wenn der Operand LINK angegeben ist. 


LOGPW=kennwort4 
Angabe des Kennworts zum Aufbau einer logischen Verbindung. 


Funktion des Kennworts: Dieses Kennwort ist von dem Kommunikationspartner einer DCAM- 
Anwendung unter dem Operanden LOGPASS im entsprechenden ACB-Steuerblock vorgege- 
ben worden. Jeder zum Verbindungsaufbau auffordernde Partner muß dieses Kennwort 
angeben. 


Dieser Operand wird von DCAM ausgewertet bei: 
— YOPNCON mit OPTCD = ACQUIRE im RPB. 


© kennwort4 kann als Zeichenkonstante: C’konstante’ oder Sedezimalkonstante: 
X'konstante’ іп der Länge von 4 Bytes angegeben werden. 


Der Standardwert ist: Х”00000000”, gleichbedeutend mit Кейт Kennwort 
angegeben‘. 
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TRUNC 
PROC= 


KEEP 


TRUNC Wenn die Nachricht länger ist, als die im Makroaufruf YRECEIVE angege- 
bene Länge, wird der zu lange Teil abgeschnitten und gelöscht. 


Der YRECEIVE-Aufruf wird ausgeführt. Es wird jedoch eine Rückmeldung 
(siehe Anhang A.2) erzeugt, die den Überlauf anzeigt. Im ARECLN-Feld 
(siehe Anhang A.1) des Steuerblocks RPB wird die Länge des Datenrestes 
angezeigt. 


KEEP Wenn die Nachricht länger ist, als die im Makroaufruf YRECEIVE angege- 
bene Länge, wird der zu lange Teil für einen nachfolgenden YRECEIVE 
(OPTCD=SPEC) aufgehoben. 


Der YRECEIVE-Aufruf wird ausgeführt. Es wird jedoch eine Rückmeldung 
(siehe Anhang А.2) erzeugt, die besagt, daß ein Überlauf besteht und die 
Daten aufgehoben wurden. Im ARECLN-Feld (siehe Anhang A.1) des Steu- 
erblocks RPB wird die Länge des Datenrestes angezeigt. 


Der Operand wird von DCAM ausgewertet bei: 
— YOPNCON, 
— ҮСНАМСЕ, 


— YRECEIVE, wenn OPTCD=CCBTK im RPB gesetzt wurde und die Länge der übermittelten 
Nachricht größer als der im AAREALN-Feld angegebene Wert ist. 


— YSENDREC, wenn OPTCD=CCBTK іт АРВ gesetzt wurde und die Länge der übermittelten 
Nachricht größer als der im AAREALN-Feld angegebene Wert ist. 


Die im Makroaufruf YRECEIVE gemachte Angabe über die Daten überlaufsbehandlung 
OPTCD=TRUNC oder =KEEP im RPB hat vor der hier gemachten Angabe Vorrang. 


Hinweis: 


In einfach benutzbaren DCAM-Anwendungen oder in mehrfach benutzbaren DCAM-Anwen- 
dungen mit ATTR=NDISCO im ACB wird die KEEP-Funktion nur ausgeführt, wenn der Partner 
im CS-Zustand (siehe 4.21) ist oder vom YRECEIVE-Aufruf, der den ersten Teil der Nachricht 
empfangen hat, in den CS-Zustand versetzt wird. Der Rest der Nachricht kann nur mit einem 
YRECEIVE, OPTCD=SPEC im RPB empfangen werden, der von dem Prozeß angegeben wird, 
der den CS-Zustand verursachte. Wenn dieser Prozeß vorzeitig beendet wird, geht der Rest 
der Nachricht verloren. 


In DCAM-Anwendungen mit dem Attribut ATTR=DISCO іт ACB kann der Rest der Nachricht 
mit einem YRECEIVE, OPTCD=SPEC im RPB empfangen werden, der von irgendeinem 
Prozeß der DCAM-Anwendung ausgegeben wird. Der Benutzer muß selbst sicherstellen, daß 
der richtige Prozeß bedient wird. 
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SYSCODE 
© PROC= 
BINARY 


SYSCODE Die Benutzerdaten sind im EBCDI-Code verschlüsselt. D.h., zu sendende 
Nachrichten sind im EBCDI-Code verschlüsselt und empfangene Nachrich- 
ten werden im EBCDI-Code erwartet. Wenn die empfangene Nachricht in 
einem anderen Code verschlüsselt ist, leitete DCAM die Nachricht weiter 
und beendet den YRECEIVE-Aufruf mit einer Warnung bei der Rückmel- 
dung (siehe Anhang A.2). 


Der Datentransport im Kommunikationssystem ist nicht transparent. Wenn 
nötig, wird eine Codeübersetzung in den Code des Kommunikationspart- 
ners vor der Weiterleitung der Daten durchgeführt (z.B. bei Ausgabe auf 
eine Datenstation). 


BINARY Die Benutzerdaten sind in einem beliebigen Code verschlüsselt. D.h., der 
Benutzer verschlüsselt zu sendende Nachrichten in diesem Code und 
erwartet empfangene Nachrichten im beliebigen Code. 


Der Datentransport im Kommunikationssystem ist transparent. Es wird 

keine Codeübersetzung vom System vorgenommen. Wenn der Partner eine 

Datenstation ist, bedient durch eine Prozedur, die keine HDLC-Prozedur ist, 
Ç gelten die folgenden Regeln: 


— Steuerzeichen, die sich im Bitmuster befinden, werden durch DLE- 
Zeichen deaktiviert. 


— Diese Deaktivierung ist jedoch nur dann wirksam, wenn die Datensta- 
tion eine transparente Datenübermittlung verarbeitet. Andernfalls muß 
sich der Benutzer davon überzeugen, ob das Bitmuster keine uner- 
wünschten Steuerzeichen enthält. 


Der Operand wird von DCAM ausgewertet bei: 


YOPNCON, 
YCHANGE, 
YSEND, 
YRECEIVE, 
YSENDREC, 


jedoch nur, wenn EDIT=USER gesetzt wurde. 
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APPSTART 
PROC= 


ANYSTART 


APPSTART Die DCAM-Anwendung, die zum Verbindungsaufbau auffordert bzw. die 
Aufforderung annimmt, wird mit der Datenübermittlung beginnen. Die 
Angabe des Akzeptierenden majorisiert die des Auffordernden. 


ANYSTART Es wird keine Angabe über den Beginn der Datenübermittlung gemacht. 
Der Operand wird von DCAM ausgewertet bei: | 
— YOPNCON 


Der aufgeforderte Partner kann sich informieren, welche Variante vorgeschlagen wurde, 
indem er das Feld PROC im CCB abfragt (siehe 3.2.2.1 und 3.2.2.2). 


Der auffordernde Partner kann sich über die endgültige Festlegung informieren, indem er das 
Feld PROC im CCB abfragt. 


SIGNAL 
PROC= 


NSIGNAL 


SIGNAL DCAM steuert die Nachrichtenübermittlung durch ein GO-Signal: Nach 
einer Überlastung der Verbindung wird dem sendenden Prozeß durch ein 
Go-Signal mitgeteilt, daß er mit dem Senden fortfahren kann. 


Der Benutzer muß bei jedem YSEND-Aufruf einen gültigen EID für das 
Go-Signal angeben. 


NSIGNAL Es wird kein GO-Signal gegeben, wenn die Überlastung der Verbindung 
aufgelöst ist. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YSEND 


USERFLD=benutzerfeld 


Der Benutzer erhält die hier festgelegte Begleitinformation immer mitgeliefert, wenn auf diese 
Verbindung bezogene Ereignisse eintreten oder Nachrichten ankommen. 


Der Operand wird von DCAM ausgewertet bei: 


— YOPNCON 
— ҮСНАМСЕ 


benutzerfeld kann als Zeichenkonstante: Ckonstante oder Sedezimalkonstante: 
X’konstante’ oder Festpunktkonstante: F’konstante’ oder Adreßkon- 
stante: A’konstante’, V(konstante) in der Länge von 4 Bytes definiert 
werden. 


Der Standardwert ist Х”00000000!, gleichbedeutend mit keine Begleitin- 
formation’ definiert. 


Bei einem Makroaufruf, der sich auf einen RPB-Steuerblock bezieht, wird dem Benutzer die 
Begleitinformation im USER-Feld des RPB-Steuerblocks übergeben (siehe Anhang А.1). 


Hat der Benutzer eine LOSCON-, EXPR- oder TACK-Contingency-Routine (siehe Kapitel 2) 
definiert und wird ein entsprechendes Ereignis gemeldet, so erhält er den Inhalt von USERFLD 
im Register 5 der entsprechenden Contingency-Routine. 
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МАХ М = absexp 


< Maximale Lànge der Daten (TSDU = Transport Service Data Unit), die von der DCAM-Anwen- 
dung auf dieser Verbindung gesendet werden sollen. 


Dieser Wert wird nicht an den Kommunikationspartner weitergegeben; er dient lediglich der 
Optimierung der vom System bereitgestellten Puffer. 


DCAM gibt den vom System angenommenen oder reduzierten Wert im MAXLN-Feld des CCB 
zurück (vgl. Anhang A.1). 


Bei EDIT= USER entspricht eine durch YSEND gesendete Nachricht 1 TSDU. 


Bei EDIT=SYSTEM und EDITOUT=PHYS oder FORM muß die physikalische Länge der 
Nachricht um mindestens 9 Bytes kürzer sein als MAXLN. Die Beachtung der Kapazität des 
Geräts liegt beim Benutzer bzw. FHS. 


Bei EDIT=SYSTEM und EDITOUT=LINE kann DCAM eine durch das System editierte 
Nachricht in Teilstücken der Größe Min.(MAXLN, Gerätekapazität) senden. 


Beim Editiervorgang wird abgeschnitten (FDBK: 04002C00), wenn ein editierter logischer Satz 
länger als MAXLN ist. 


Die mit einem YSEND-Aufruf gesendete Nachricht darf bei EDIT=SYSTEM maximal 32767 
© Bytes groß sein. 


Hinweis 


Editierte Daten sind immer länger als Anwender-Daten, da Kontrollzeichen umgewandelt und 
Protokolletiketten hinzugefügt werden. 


Angeforderte MAXLN | < 65530 keine Angabe 
DCAMVER ARa keine Angabe 


Ergebnis іт MAXLN- | < 65530 ”) 


Feld 
mit DVR 4096 | 4096 
mit DAST 4096 | 32767 


*) Die Ergebnisse sind abhängig von der HW/SW-Konfiguration (siehe Manual "Generie- 
rung und Administration eines Datenkommunikationssystems'’). 
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4.4 


YCHANGE 


Funktion 


Dieser Makroaufruf ändert bestimmte Eigenschaften einer bereits aufgebauten Verbindung, 
die im Steuerblock CCB beschrieben werden (siehe auch 3.2.4). | 


Er kann nur von einem Primärprozes aufgerufen werden. 


Format 


Format Operanden 


[symbol] | YCHANGE RPB=addr 


[,schlüsselwort=neuer wert, . . . ] 


Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YCHANGE von Bedeutung: 


schlüsselwort neuer Wert 


(register) 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) oder die Tabelle der Steuerblockfel- 
der (Anhang А.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (siehe 3.2.4 und Anhang А.2). 
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4.5 YCLOSE 


Funktion 


Der YCLOSE schließt eine DCAM-Anwendung für einen Prozeß bzw. löst sie auf (siehe auch 
3.1.4). 


Format 


Name Operanden EK 


[symbol] | YCLOSE ACB=addr 
AlD=(register) 

Operanden 

ACB=addr 


Adresse des ACB-Steuerblocks, der das Kennzeichen der DCAM-Anwendung enthält, die 
geschlossen werden soll. 


AlD=(register) 


Nummer des Registers, welches das Kennzeichen (AID) der zu schließenden DCAM-Anwen- 
dung enthält. 
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4.6 


YCLSCON 


Funktion 


Der YCLSCON-Makroaufruf nimmt eine vorher gegebene Aufforderung zum Verbindungsauf- 
bau (ҮОРМСОМ ACQUIRE) zurück, wenn der Aufbau noch nicht erfolgte oder er baut die 
Verbindung zu einem Kommunikationspartner ab (siehe auch Abschnitt 3.2.5). 


YCLSCON kann nur von einem Primärprozeß aufgerufen werden. Daten, die sich nach diesem 
Aufruf noch in Pufferspeichern des Systems befinden, sind nicht mehr erreichbar. 


Format 
Name Operanden 
[symbol] YCLSCON RPB=addr 
[,schlüsselwort=neuer wert,....] 
Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YCLSCON von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 
AID (register) 
CCB addr 
CID (register) 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) oder die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (siehe 3.2.5 und Anhang A.2). 
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4.7 ҮСОММ 


Funktion 


Der Makroaufruf YCONN wird verwendet, um in der prozeßspezifischen Tabelle CLT (commu- 
nication link table) Angaben über eine logische Verbindung zu speichern oder zu löschen. 


Dieser Makro wendet die Namen-Zuweisungsfunktion an (siehe 3.4). 


Format 
Name Operanden 
[symbol] | YCONN partnername 
] 
(register) 
kettungsname 
, LINK= 
(register) 
ç prozname 
[ , PRONAME= 
(register) 
benutzerfeld 
[, USERFLD= 
(register) 
kennwort4 
[ , LOGPW= 
(register) 
Operanden 
partnername 
(register) 
partnername gibt den Namen des Kommunikationspartners an. 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A-Z, e #, 
© $), d.h., der Name muß den Konventionen für Assembler-Namen entspre- 
chen. 
(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Partnername 


linksbündig steht. Nach rechts sind freie Bytes mit ZWR (Х'40') aufzufüllen. 


ОСАМ У8.0А ОСАМ Makroaufrufe, 987-.)-275-2 4-27 


ҮСОММ 


kettungsname 
LINK= 


(register) 


kettungsname gibt den Kettungsnamen an. x 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A-Z, @, #), 
d.h., der Name muß den Konventionen für Assembler-Namen entsprechen. 


(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Kettungsname 
linksbündig steht. Nach rechts sind freie Bytes mit ZWR (Х'40') aufzufüllen. 


Wenn dieser Operand alleine angegeben ist, werden frühere Eintragungen in der CLT unter 
gleichem Kettungsnamen gelöscht. 


prozname 
PRONAME= 


(register) 


prozname gibt den Prozessornamen des Partners an. 
Er kann maximal 8 Bytes lang sein und muß alphanumerisch und linksbün- 
dig ausgerichtet sein. Das erste Zeichen muß alphabetisch sein (A-Z, e ж, 
$), d.h., der Name muß den Konventionen für Assembler-Namen entspre- 
chen. 


(register) enthält die Adresse eines 8 Bytes langen Feldes, in dem der Prozessorname 
linksbündig steht. Nach rechts sind freie Bytes mit ZWR (Х'40') aufzufüllen. 


benutzerfeld 
USERFLD= 


(register) 


benutzerfeld gibt ein Feld an, in dem der Benutzer eine Begleitinformation hinterlegt. 
Dieses Feld kann maximal 4 Bytes lang sein und ist eine Zeichenkonstante: 
C’konstante’ oder eine Sedezimalkonstante: X’konstante‘. 


(register) enthält die Adresse einer 4 Bytes langen Adreßkonstanten, in der die 
Begleitinformation rechtsbündig steht. 
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kennwort4 | 


© LOGPW= 
(register) 


kennwort4 gibt das Kennwort zum Aufbau einer Verbindung an, gegeben vom Kommu- 
nikationspartner der dazu auffordert. Das Kennwort ist 4 Byte lang und ist 
eine Zeichenkonstante: C’konstante’ oder eine Sedezimalkonstante: X’kon- 
stante’. 


(register) enthält die Adresse einer 4 Bytes langen Adreßkonstanten, in der das 
Kennwort rechtsbündig steht. 


Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register |Rückinformation Bedingung 


15 
links- 
bündig 


Der Aufruf wurde nicht 
| ausgeführt, weil nicht 
© genug Speicherplatz vor- 
handen war. 


Der Aufruf wurde wie 
gewünscht ausgeführt. 


X'08' Der angegebene Kettungsname 
wurde nicht verwendet. 


Der Aufruf konnte wegen eines 


Systemfehlers nicht ausgeführt 
werden. 
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4.8 


YDCG 


Funktion 


Es wird ein Verteilcode-Gruppenblock (DCG=distribution code group block) erzeugt. Er 
enthält die Beschreibung von einem oder mehreren Verteilcodes (siehe auch 3.2.1.4 und 


3.2.4). 


Format 


[symbol] | YDCG CODEVAL=(codewert,....) 


Name Operanden 


Operanden 

CODEVAL=(codewert,....) 

Liste von Verteilcodewerten. Es können bis zu 8 Werte in der Liste stehen. 
codewert kann eine Folge von maximal 8 Zeichen sein und als 


C’konstante’ | 


Zeichenkonstante: 
konstante 


oder Sedezimalkonstante: Х.Копвїате” angegeben werden. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON, wenn der im DIP-Steuerblock adressierte DCG-Steuerblock kein gültiges 


GID-Kennzeichen enthält, 


— YCHANGE, wenn der im DIP-Steuerblock adressierte DCG-Steuerblock kein gültiges 


GID-Kennzeichen enthält, 


— YPERMIT, wenn der in AAREA adressierte DCG-Steuerblock kein gültiges GID-Kennzei- 


chen enthält, 


— YPERMIT, wenn der DCG ein gültiges Kennzeichen GID enthält und der Operand CODE- 


VAL vor dem Permit mit YMODCB geändert wurde. 


Die Verteilcodewerte für eine Verbindung müssen eindeutig sein, d.h. derselbe Verteilcode- 
wert darf nicht in verschiedenen DCG-Steuerblöcken, die von einem DIP-Steuerblock adres- 


siert werden, vorkommen. 


Nachrichten, die ungültige Verteilcodewerte enthalten, werden dem Primärprozeß überge- 


ben. 
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4.9 YDIP 


Funktion 


Es wird ein Verteilungsparameter-Block (DIP = distribution parameter block) erzeugt. Er 
enthält Lage und Länge des Verteilcodes einer Nachricht sowie Verweise auf DCG-Steuer- 
blöcke (siehe auch 3.2.1.4 und 3.2.4). 


Format 
Name Operanden 
[symbol] | YDIP [CODELN=absexp] 


[, CODEPOS=absexp] 
[,CODEIND=character] 


[,DCG=(relexp,...)] 


ç Operanden 


CODELN=absexp 


Länge des Verteilcodes in Bytes, Standardwert ist Null. Der Verteilcode kann bis zu 
8 Zeichen lang sein. Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON 


CODEPOS=absexp 


Distanz des Verteilcodes relativ zum ersten Byte (уоп links gelesen) der empfangenen Daten. 
Das erste Zeichen hat die Distanz Null, Standardwert ist Null. 


Die Distanz darf: | 

— den Wert 255 nicht überschreiten 

— nicht größer sein, als die Gesamtlänge (Nachricht + Verteilcode) der Nachricht. 
Dieser Operand wird von DCAM ausgewertet bei: 


© — YOPNCON 
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CODEIND=character 


Legt ein Zeichen fest, das anzeigt, daß die folgenden (max.7) Zeichen als Verteilcode 
interpretiert werden sollen. Es kann codiert werden als 1 Byte lange C-Konstante: 


C’:Konstante:’ bzw. :Konstante: oder 

sedezimal: Х':Копѕїапїе:' 

Der Standardwert ist Х'00'. Er besagt: 

— kein impliziter Verteilcode wird verwendet; 

— expliziter Verteilcode wird in jeder Nachricht erwartet. 
Der Operand wird von DCAM ausgewertet bei 

— YOPNCON 

Hinweis: 


Der Codeanzeiger steht an der in CODEPOS angegebenen Stelle. 


ПСб-(ге1ехр,...) 
Liste der DCG-Steuerblockadressen. Es sind maximal 16 Adressen angebbar. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON 
— YCHANGE 
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Funktion 


Es wird ein Ereignis-Meldungsblock (ENB=event notification block) erzeugt. Er enthält die 
Adressen der Contingency-Kennzeichen (siehe Kapitel 2). 


Format 


Name Operanden 
[symbol] | YENB [COMEND=relexp] | 4 
[,EXPR=relexp] 
[,LOGON=relexp] 
[,LOSCON=relexp] 
[, PROCON=relexp] 
ç [, ТАСК=ге1ехр] 


[,SECOND=relexp] 


Operanden 

COMEND=relexp 

Adresse eines Feldes, in dem das COMEND-Contingency-Kennzeichen steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN 


EXPR=relexp 
Adresse eines Feldes, in dem das EXPR-Contingency-Kennzeichen steht. 
Dieser Operand wird vom DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß 
© — YOPEN durch einen Sekundärprozeß mit ATTR=NDISCO im ACB 


LOGON=relexp 
Adresse eines Feldes, in dem das LOGON-Contingency-Kennzeichen steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— ҮОРЕМ durch einen Primärprozeß 


LOSCON=relexp 
Adresse eines Feldes, in dem das LOSCON-Contingency-Kennzeichen steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN. 
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PROCON=relexp 
Adresse eines Feldes, in dem das PROCON-Contingency-Kennzeichen steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN durch einen Primärprozeß. 


TACK=relexp 
Adresse eines Feldes, in dem das TACK-Contingency-Kennzeichen steht. 
Dieser Operand wird von DCAM ausgewertet bei: 


— YOPEN durch einen Primärprozeß mit ATTR=PRIMTASK im ACB 
— ҮОРЕМ durch einen Sekundärprozeß mit ATTR=REOTASK іт АСВ 


Hinweis: 


Die jeweiligen Contingency-Kennzeichen werden nach Ausführung des Makroaufrufs ENACO 
(enable contingency) zurückgegeben (Operand COIDRET). 


SECOND=relexp 


Adresse des Feldes, in dem das SECOND-Contingency-Kennzeichen steht. Dieser Operand 
wird von DCAM ausgewertet bei 


— ҮОРЕМ durch den Primärprozeß. 
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4.11 YFORBID 


Funktion 


Mit diesem Aufruf wird eine Zuordnung von einer Verteilcode-Gruppe (wie sie in einem 
DCG-Steuerblock beschrieben ist) zu einem Verteilungsnamen wieder gelöst. Der Prozeß, der 
den betreffenden Verteilungsnamen definiert hat, ist ab diesem Zeitpunkt nicht mehr in der 
Lage, Nachrichten zu empfangen (siehe auch 3.3.5.2). 


YFORBID kann nur von einem Primärprozeß aufgerufen werden. 


Format 
Name Operanden 
[symbol] | YFORBID RPB=addr 
[,schlüsselwort=neuer мег, ... | 
Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Beschreibung des YFORBID von Bedeutung: 


schlüsselwort neuer wert 
ACB addr 
AID ЖЗНЕ 
АВЕА addr 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21 und die Tabelle der Steuerblockfelder 
Anhang A.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (siehe 3.3.5.2 und Anhang A.2). 
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4.12 


YGENCB 


Funktion 


Der YGENCB-Makroaufruf erzeugt einen oder mehrere identische Steuerblöcke und zwar 


während des Programmablaufs. 


Wird ein Speicherplatz (WAREA) angegeben und die Länge des Bereiches (LENGTH), werden 
die Steuerblöcke an dieser Stelle im Programm (Klasse-6-Speicher) erzeugt. Werden keine 
Angaben gemacht, werden die Steuerblöcke in einem von DCAM verwalteten Bereich 


(Klasse-5-Speicher) erzeugt. 


Format 
Name Operanden 
[symbol] YGENCB ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 
1 
[ ,COPIES= ] 
integer 
[,МАВЕА=аааг | 
[ , LENGTH=value] 
L 
[,MF= ] 
(E,addr) 
, Schlüsselwort=anfangswert,... 
Operanden 
ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 


Es wird der Typ des Steuerblocks oder der Steuerblöcke angegeben, der(die) erzeugt werden 


sollen), 
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1 
© СОРІЕ5- | 
integer 


Es wird die Anzahl der zu erzeugenden Steuerblöcke festgelegt. Es sind höchstens 255 
Steuerblöcke zulässig. 


WAREA=addr 


Anfangsadresse des Speicherbereichs im Programm, in dem der Block (die Blöcke) erstellt 
werden soll(en). 


Der Bereich muß an einer Wortgrenze beginnen. Wird diese Angabe gemacht, muß auch die 
nächste gemacht werden. 


LENGTH=value 


Gibt die Länge (in Bytes) des mit WAREA bestimmten Bereichs an. Folgende Mindestlängen 
sind erforderlich: 


ACB 64 Bytes 

CCB 80 Bytes 
© RPB 88Bytes 
ENB 36 Bytes 

DCG 80 Bytes 

ОР 80 Bytes 


Da in künftigen Versionen mit Erweiterungen zu rechnen ist, wird empfohlen, größere 
Bereiche zu wählen. 


L 
(E, addr) 


Gibt die Form des Makroaufrufs an (siehe 2.1.2). 


schlüsselwort=anf angswert 


Gibt die Anfangswerte eines oder mehrerer Steuerblockfelder an. Die Felder, die nicht 
angegeben werden, werden mit Standardwerten versehen, wie sie bei den Beschreibungen 
© der Aufrufe zur statischen Steuerblockerzeugung aufgeführt sind. 


Die Angaben für ’schlüsselwort’ und "anfangswert’ sind der Tabelle der Steuerblockfelder zu 
entnehmen (Anhang A.1). 
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Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register |Rückinformationen Bedingung 


(Gesamt)länge des 
(der) erzeugten 
Steuerblocks 
(Steuerblöcke) in 
Bytes. 


Benötigte Länge im 
Benutzerbereich 


Adresse des ersten 
Bytes des (der) er- 
zeugten Steuerblock 
(-blöcke) 


links- 
bündig 


Der Steuerblock wurde in 
einem dynamisch zugewiesenen 
Speicherbereich erzeugt 
(kein WAREA- und LENGTH- 
Operand gesetzt). 


Der Benutzerbereich ist zu 
klein (gesetzter LENGTH-Ope- 
rand). 


Der Steuerblock wurde in 
einem dynamisch zugewiesenen 
Speicher-Bereich erzeugt. 


Der Steuerblock wurde erfolg- 
reich erzeugt. 


Entweder war der Benutzer- 
Bereich zu klein (siehe Regi- 
ster 0), oder es konnte nicht 
genug (dynamisch zugewiesener) 
Speicherbereich beschafft 
werden. 


Obligatorischer Operand 
fehlt 


Der durch WAREA gekennzeich- 
nete Bereich beginnt nicht an 
einer Wortgrenze 


Das Steuerblockfeld ist nicht 
ein Feld des mit BLK festge- 
legten Steuerblocks. 


Die Adresse im MF-Operanden 
verweist nicht auf eine 
L-Form-Operandenliste. 


Die Adresse des Benutzerbereichs 
ist ungültig. 


Ungültige Parameterliste oder 
Registernummer. 


Für die Inhalte von Register 15 können mit dem Makroaufruf YDDFDB (siehe Anhang A.7) 
symbolische Adressen generiert werden. 
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YINQUIRE 


YINQUIRE 


Funktion 


Mit diesem Aufruf kann ein Prozeß Informationen, eine DCAM-Anwendung betreffend (siehe 
3.1.3) oder Kommunikationspartner und Verbindungen betreffend (siehe 3.2.2), abfragen. 


Format 


Name Operanden 


[symbol] | YINAUIRE | RPB=addr 


[,schlüsselwort=neuer wert, ... | 


Operanden 
RPB=addr 
Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YINQUIRE von Bedeutung: 


schlüsselwort neuer wert 
ACB addr 

AID (register) 
CCB addr 

CID (register) 
AREA addr 
AREALN value 
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schlüsselwort 
AAREA 
AAREALN 


LID 


OPTCD 
OPTCD 
OPTCD 
OPTCD 
OPTCD 
OPTCD 


OPTCD 


neuer wert 
addr 
value 


(register) 


APPSTAT 
REQLOGON 
TOPLOGON 
COUNTPTN 
PTNCHAR 
CIDXLATE 


NAMXLATE 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 


der (Anhang А.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 


men (siehe 3.1.3 und 3.22 und Anhang A.2). 
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4.14 YMODCB 


Funktion 


Mit diesem Aufruf können eines oder mehrere Felder in Steuerblöcken des Benutzerbereichs 
geändert werden (siehe 2.4.2). Die Änderung hat keine Auswirkung auf die Kopien, die DCAM 
übernommen hat. 


Es gelten die folgenden Einschränkungen für den Gebrauch уоп YMODCB: 


— Ein RPB-Steuerblock darf nicht geändert werden, während er gerade aktiv ist (z.B. 
während er für einen asynchron auszuführenden Befehl gebraucht wird, der noch nicht 
beendet ist). 


— Ein CCB-Steuerblock darf nicht geändert werden, während sich seine Adresse im CCB- 
Feld eines gerade aktiven RPB-Steuerblocks befindet. 


Format 
Name Operanden 
© [symbol] YMODCB ACB 
А ССВ 
DCG 
BLK= 
DIP 
ENB 
RPB 
‚BLKADDR=addr 
L 
|,МЕ- | 
(E,addr) 
‚schlüsselwort=neuer wert,... 
Operanden 
ACB 
CCB 
DCG 
© BLK= 
DIP 
ENB 
RPB 


Gibt den Typ des Steuerblocks an, der geàndert werden soll. 
BLKADDR=addr 


Gibt die Adresse des Steuerblocks an, der geàndert werden soll. 


L 
r- | 
(E. adr) 


Gibt die Form des Makroaufrufs an (siehe 2.1.2). 
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schlüsselwort = neuer wert 


Hier werden die Werte in den Steuerblockfeldern aktualisiert. Besteht ein Operand vom Typ 
'code' aus mehreren möglichen Angaben (z.B. OPTCD-Operand), werden nur die angegebe- 
nen geändert. Die Angaben für 'schlüsselwort’ und "neuer wert’ sind der Tabelle der Steuer- 
blockfelder zu entnehmen (Anhang А.1). 


Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register |Rückinformationen |Bedingung 


15 YMODCB wurde erfolgreich durch- 
geführt. 
links- Die Stelle, die durch BLKADDR 
bündig angezeigt wird, enthält keinen 


gültigen Steuerblock. 
Obligatorischer Operand fehlt. 


Es sollte ein Steuerblockfeld 
geändert werden, für das Ände- 
rungen nicht erlaubt sind. 


Der Steuerblock, dessen Adresse 
durch BLKADDR angegeben wurde, 
ist nicht von авг Art, die іп 
BLK angegeben wurde. 


Das Steuerblockfeld ist keines 
des angegebenen Steuerblocks. 


Die Adresse im MF-Operanden ver- 
weist nicht auf eine L-Form 
Operandenliste. 


Die Adresse des Steuerblocks 
ist ungültig. 


RPB/CCB wird bereits von einem 
asynchronen Aufruf benutzt oder 
ungültige Parameterliste oder 
ungültige Registernummer. 


Für die Inhalte von Register 15 können mit dem Makroaufruf YDDFDB (siehe Anhang А.7) 
symbolische Adressen generiert werden. 
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4.15 ҮОРЕМ 


Funktion 


Dieser Aufruf eröffnet eine DCAM-Anwendung für einen Prozeß und erzeugt die DCAM- 
Anwendung, falls sie noch nicht existiert (siehe auch 3.1.1). 


Format 


[symbol] | YOPEN ACB=addr 


Operand 
ACB=addr 


Adresse des ACB-Steuerblocks, der die zu eröffnende Anwendung beschreibt. 


<Ñ Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (siehe auch 3.1.1 und Anhang A.2). 
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4.16 YOPNCON 


Funktion 


Dieser Aufruf fordert zum Aufbau einer Verbindung auf (OPTCD=ACQUIRE: siehe 3.2.1.2) 
bzw. nimmt eine Aufforderung zum Verbindungsaufbau 
(OPTCD=ACCEPT) an (siehe 3.2.1.3). 


YOPNCON kann nur von einem Primärprozeß aufgerufen werden. 


Format 


Name Operanden 


[symbol] | YOPNCON RPB=addr 


[,schlüsselwort=neuer wert, . . . | 


Operanden 
RPB=addr 
Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Beschreibung des YOPNCON von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 
AID (register) 
CCB addr 
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schlüsselwort neuer wert 


OPTCD кт. | 


ACQUIRE 


EID addr 

EIDREF information 
nr | 

АВЕА ачаг 

AREALN value 


TOVAL value 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang А.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (3.2.1 und Anhang А.2). 
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4.17 


\ 


YPERMIT 


Funktion 


Mit diesem Aufruf wird eine Zuordnung von einer Verteilcode-Gruppe (wie sie in einem 
DCG-Steuerblock beschrieben ist) zu einem Verteilungsnamen hergestellt. Der Prozeß, der 
den betreffenden Verteilungsnamen definiert hat, empfängt ab diesem Zeitpunkt die Nach- 
richten, die einen der Verteilcodes enthalten, der im zugeordneten Steuerblock DCG beschrie- 
ben ist. 


Da maximal 8 Prozesse denselben Verteilungsnamen definieren können, ist mit diesem Aufruf 
unter Umständen noch keine eindeutige Zuordnung von Nachricht zu Prozeß gegeben. 


Wird YPERMIT erneut aufgerufen, kann damit eine bestehende Verknüpfung durch eine neue 
ersetzt werden (siehe auch 3.3.5.1) oder eine Verteilcode-Gruppe kann modifiziert werden. 
YPERMIT kann nur von einem Primärprozeß aufgerufen werden. 


Format 


Name Operanden 


[symbol] | YPERMIT RPB=addr 


[,schlüsselwort=neuer vert... | 


Operanden 

RPB=addr 

Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YPERMIT von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 
AID (register) 
AAREA addr 
AREA addr, 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe 3.3.5.1) und der Tabelle der Meldun- 
gen zu entnehmen (Anhang А.2). 
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4.18 YRECEIVE 


Funktion 


Mit diesem Aufruf wird das Übertragen (Empfangen) von Daten in den Speicherbereich des 
Benutzers eingeleitet. Es können Nachrichten, Expreßnachrichten und Transportquittungen 
empfangen werden (siehe auch 3.3.2). 


Format 


Name Operanden 


[symbol] | YRECEIVE | RPB=addr 


[,schlüsselwort=neuer мег%,... | 
Operanden 
RPB=addr 
© Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YRECEIVE von Bedeutung: 


schlüsselwort neuer wert 
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ACB addr 

AID (register) 

CCB addr 

CID (register) 

AAREA addr 

AAREALN value 

OPTCD SPEC 

ім) 

АМҮ 


ҮВЕСЕ!МЕ 


schlüsselwort neuer wert 


OPTCD LS 
» | 
СА 
ТВОМС 
(,1КЕЕР +) 
ССВТК 
ЕТП аааг 
ЕТПВЕЕ information 
(register) 
TOVAL value 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Hinweis: 


Ein YRECEIVE mit OPTCD= ANY kann bereits gegeben werden, wenn noch keine Verbindung 
aufgebaut worden ist. Der erfolgreiche Abschluß setzt allerdings den Aufbau mindestens 
einer Verbindung voraus. 


Wird mit ОРТСО = Q gearbeitet und OPTCD=SYN, muß beachtet werden, daß während der 
Wartezeit eine Unterbrechung durch Anstoß einer Contingency-Routine erfolgen kann. Wird 
dort ebenfalls ein YRECEIVE mit ОРТСО = О gegeben, wird er zurückgewiesen. 


Bei blockweiser Übertragung einer Eingabenachricht von einer Datenstation aus muß jeder 
Block mit einem YRECEIVE-Aufruf empfangen werden. 


Beim Empfang des ersten Blockes einer Eingabenachricht wird diese Verbindung von DCAM 
in den CS-Zustand gesetzt. Das bedeutet, daß die folgenden Blöcke bis zum letzten mit 
OPTCD=SPEC empfangen werden müssen. 


Die Verbindung bleibt im CS-Zustand bis der letzte Block abgeholt wird, d.h., die CS/CA- 
Option des YRECEIVE, der den letzten Block abholt, wird ausgewertet. 


Unabhängig vom Empfang im Block-Modus muß der Benutzer CS-Option bei einem YRE- 
CEIVE, OPTCD=KEEP angeben. 


Bei einer blockweisen Eingabe von der Datenstation zeigt GROUP an, daß die Eingabe beendet 
ist. SUBGROUP/ELEMENT bedeuten, daß die Eingabe noch nicht beendet ist, der nächste 
Block ist durch YRECEIVE abzuholen. DCAM zeigt die Datengruppierung im ҒОВК4 der 
Rückinformation an (siehe А.2). 


Einschränkung: 
Ein Prozeß kann gleichzeitig absetzen: 


— maximal 8 ҮКЕСЕІМЕ ANY pro Anwendung und Prozeß 
— maximal 8 ҮКЕСЕІМЕ SPEC pro Verbindung. 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung und der Tabelle der Meldungen zu entneh- 
men (siehe 3.3.2 und Anhang А.2). 
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4.19 YREJLOG 


Funktion 


Mit diesem Aufruf wird eine Aufforderung zum Aufbau einer Verbindung zurückgewiesen 
(siehe auch 3.2.3). 


Er kann nur in einem Primärprozeß gegeben werden. 


Format 
Name Operanden 
[symbol] YREJLOG RPB=addr 
[,schlüsselwort=neuer wert, ... | 
Operanden 
RPB=addr 
ç Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YREJLOG von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 
AID (register) 
AAREA addr 
AREA addr 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe auch 3.2.3) und der Tabelle der 
Meldungen (Anhang A.2) zu entnehmen. 
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4.20 


YRESET 


Funktion 


Noch anstehende YRECEIVE-Aufrufe können zurückgenommen werden. Der CS/CA-Zustand 
kann bei einer bestimmten Verbindung geändert werden. 


Format 
Name Operanden 
[symbol] YRESET RPB=addr 
[,schlüsselwort=neuer мег, ... | 
Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort= neuer Wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Makroaufruf YMODCB 
aktualisiert werden. 


Folgende Angaben sind bei der Bearbeitung des YRESET von Bedeutung: 


schlüsselwort neuer Wert 
ACB addr 

AID (register) 
CCB addr 

CID (register) 
OPTCD SPEC 

[ 
ANY 


cs 
1 N 
СА 


Zur Beschreibung der einzelnen Felder siehe RPB (4.21) und die Tabelle der Steuerblockfelder 
(Anhang A.1) 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe 3.3.4) und der Tabelle der Meldungen 
(Anhang A.2) zu entnehmen. 
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Funktion 


YRPB 


Es wird ein Anforderungsparameter-Block (RPB = request parameter block) erzeugt. 


Format 


[symbol] | YRPB 
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Operanden 
[AAREA=relexp] 
[,AAREALN=absexp] 
|,АСВ-ге1ехр| 
[,AREA=relexp] 
[,AREALN=absexp] 
[,CCB=relexp] 
[,EID=relexp] 


[,EIDREF=information] 


ACCEPT BELL CS 
ота йен 


ACQUIRE 


ELEMENT NORMAL 
зоот. d 


GROUP EXPRESS 
REQLOGON 
TOPLOGON 
NAMXLATE SPEC 

[ , 1 COUNTPTN IE | | 
АРР$ТАТ 
CIDXLATE 
PTNCHAR 


ANY 


SYN TACK TRUNC 
hee E 
ASY NTACK ССВТК 


[,SEQNO=absexp] 


[, TOVAL=absexp] 


STOP 
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Operanden 
AAREA=relexp 


Adresse eines Bereiches, in den der Benutzer Daten für DCAM bereitstellt, und indem DCAM 
Daten für den Benutzer einträgt. Was in den Bereich bereitgestellt bzw. eingetragen wird, ist 
abhängig vom gerade aktuellen Makroaufruf, der sich auf diesen RPB-Steuerblock bezieht. 


Der Benutzer stellt bereit: 
— den Namen des Partners bei YINQUIRE mit dem Орегапдеп OPTCD = МАМХІ АТЕ, 


— die Adresse des Bereichs für die Verbindungsnachricht bei YINQUIRE mit 
OPTCD=REQLOGON, 


— den symbolischen Namen des Partners bei YREJLOG, 

— die Adresse des DCG-Steuerblocks bei YPERMIT. 

DCAM trägt ein: | 

— den Namen des Partners bei YINQUIRE гай dem Operanden OPTCD=CIDXLATE, 
— die angeforderten Informationen bei YINQUIRE, 

— die empfangene Nachricht bei YRECEIVE und YSENDREC. 


- ар DCAMVER 8.0 die Verbindungsnachricht des Partners, falls bei YOPNCON der Operand 
OPTCD = ACQUIRE gesetzt wurde. 


AAREALN=absexp 
Lange (in Bytes) des Bereiches, auf den durch AAREA verwiesen wird. 
Dies kann sein die Länge der 


— Verbindungsnachricht (höchstens 80 Bytes) bei YINQUIRE mit dem Operanden ОРТС- 
D=REQLOGON, TOPLOGON. 


— empfangene Daten bei YRECEIVE und YSENDREC (mindestens 8 Bytes). 


— Verbindungsnachricht des Partners bei YOPNCON mit dem Operanden OPTCD=AC- 
QUIRE (ab DCAMVER 8.0). 


Überschreiten die empfangenen Daten die hier angegebene Länge, so erhält der Benutzer im 


FDBK-Feld (siehe Anhang A.2) des RPB-Steuerblocks, auf den sich der Empfangsmakroaufruf 
bezieht, eine Warnung. | 
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АСВ=ге1ехр 


Ç Adresse eines ACB-Steuerblocks. Er enthàlt das Kennzeichen der Anwendung, auf die sich 
der Makroaufruf bezieht, der hier beschrieben wird. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON 
— YCLSCON 

— YREJLOG 

— YSETLOG 

— YINQUIRE 
— YCHANGE 
— YPERMIT 

— YFORBID 

— YSEND 

— YRECEIVE 
— YSENDREC 


AREA=relexp 


Adresse eines Bereiches, in den der Benutzer Daten für DCAM bereitstellt, und in den DCAM 
Daten für den Benutzer eintràgt. Was in dem Bereich bereitgestellt bzw. eingetragen wird, ist 
abhängig vom gerade aktuellen Makroaufruf, der sich auf diesen RPB-Steuerblock bezieht. 


6 Der Benutzer stellt bereit: 


— die Verbindungsnachricht (höchstens 80 Bytes) bei YOPNCON mit gesetztem Operanden 
OPTCD = ACQUIRE oder (ab DCAMVER 8.0) OPTCD = ACCEPT. Der AREA-Operand wird іп 
diesem Fall nur ausgewertet, wenn der Wert für AREALN ungleich 0 ist. 


— den Namen des Partner-Prozessors bei YREJLOG und YINQUIRE mit dem Operanden 
OPTCD=NAMXLATE. 


— den Namen der DCAM-Anwendung bei YINQUIRE mit dem Operanden 
OPTCD=APPSTAT 


— den Verteilungsnamen bei YPERMIT und YFORBID. 
— die zu sendende Nachricht bei YSEND und YSENDREC. 
DCAM trägt ein: 


— den Namen des Partner-Prozessors bei YINQUIRE mit dem Operanden 
OPTCD=CIDXLATE. 


AREALN=absexp 
ç Länge des Bereiches, auf den durch AREA verwiesen wird. Dies kann sein die Länge der: 
— Verbindungsnachricht bei YOPNCON. 


— die zu sendende Nachricht bei YSEND und YSENDREC. ОСАМ übermittelt die Daten іп der 
hier angegebenen Länge, ausgehend von der im AREA-Operand angegebenen Adresse. 
Die maximale Länge einer auf einer bestimmten Verbindung sendbaren Nachricht erhält 
der Benutzer im MAXLN-Feld des CCB-Steuerblocks von DCAM übergeben. 


Wenn der Bereich AREA einen Namen (z.B. Verteilungsnamen) enthält, ist die Länge implizit 8 
Bytes, d.h. AREALN wird nicht ausgewertet. 
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ССВ=ге1ехр 


Adresse eines CCB-Steuerblocks. Er beschreibt die Verbindung, auf die sich der Makroaufruf 
bezieht, der hier beschrieben wird. 


Dieser Operand wird von DCAM ausgewertet bei: 


YOPNCON 
_ ҮСІ5С0М REQLOGON 
YINQUIRE, wenn отоо. төлі gesetzt wurde. 
PTNCHAR 
YCHANGE 
YSEND 
YRECEIVE 
YSENDREC 


EID=relexp 


Hier wird die Adresse des Ereigniskennzeichens angegeben, das der Benutzer nach Abgabe 
eines ENAEI, Operand EIIDRET, erhalten hat. 


Das Ereignis, welches hier gekennzeichnet ist, ist eingetreten, wenn die Antwort auf eine 
Verbindungsaufforderung oder -annahme erfolgte oder eine Nachricht oder ein Go-Signal 
eingetroffen ist. 


Dieser Operand wird von DCAM ausgewertet bei: 


1) YOPNCON 
2) YRECEIVE 
3) YSEND 

4) YSENDREC 


bei 1), 2), 4) nur, wenn OPTCD=(ASY,O) gesetzt wurde. In diesem Fall muß der Operand 
angegeben werden (siehe OPTCD=ASY, OPTCD=Q). 


bei 3) nur, wenn die Verbindungseigenschaft PROC=SIGNAL im CCB definiert wurde. Auch in 
diesem Fall muß der Operand angegeben werden (siehe ҮССВ, PROC = SIGNAL). 


EIDREF=information 


Diese Angabe ist eine benutzereigene Referenz von 4 Bytes Länge, die er zurückerhält, wenn 
das Ereignis eingetreten ist. Das erste (höchstwertige) Byte wird dabei mit X’0C’ überschrie- 
ben. 


Bei synchron abgesetztem SOLSIG-Aufruf verweist der Benutzer mit dem Operanden 
RPOSTAD auf den Bereich, in den die Referenz eingetragen werden soll. 


Bei asynchron abgesetztem SOLSIG-Aufruf wird die Referenz im Register 3 der zugehörigen 
Contingency-Routine übergeben. 


Dieser Operand wird von DCAM ausgewertet bei: 


_ ҮОРМСОН 

_ YRECEIVE unter den Bedingungen, wie oben 

_ ҮЗЕМП beim Operanden EID aufgeführt. 

_ YSENDREC 

information kann als Zeichenkonstante: C’konstante’ oder Sedezimalkonstante: X'kon- 


stante oder Festpunktkonstante: F'konstante' oder Adreßkonstante: A- 
(konstante) oder V(konstante) angegeben werden. 


Der Standardwert ist: X’00000000’, gleichbedeutend mit 'Кеїпе Referenz 
übergeben’. 
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АССЕРТ 
© OPTCD= 
ACQUIRE 
ACCEPT Eine Aufforderung zum Verbindungsaufbau soll angenommen werden. 
ACQUIRE Es soll zum Aufbau einer Verbindung aufgefordert werden. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YOPNCON 
BELL 
OPTCD= 
NBELL 
BELL Die Ausgaben der Nachricht an der Datenstation sollen mit akustischem 
Alarm angezeigt werden. 
NBELL Ausgabe ohne akustischen Alarm. 
CS 
OPTCD= 
CA 
“ CS Nach Beendigung des Makroaufrufs, der hier beschrieben wird, wird der 
Kommunikationspartner in den CS-Zustand versetzt. 
CS-Zustand bedeutet: Nachrichten, die vom Partner kommen, können nur 
mit OPTCD=SPEC empfangen werden, da sie in die absenderspezifische 
Warteschlange eingetragen wurden. Im Falle einer mehrfach benutzbaren 
DCAM-Anwendung gilt, daß nur der Prozeß, der den CS-Zustand verur- 
sacht hat, die nachfolgenden Nachrichten empfangen kann. 
CA Nach der Beendigung des Makroaufrufs, der hier beschrieben wird, wird 


der Partner in den CA-Zustand versetzt. 


CA-Zustand bedeutet: Nachfolgende Nachrichten, die von diesem Partner 
kommen, können nur mit OPTCD=ANY empfangen werden, da sie in die 
empfängerglobale Warteschlange eingetragen wurden. 


Dieser Operand wird von DCAM ausgewertet bei: 


YOPNCON 
YSEND 
YRECEIVE 
YRESET 


© ` YSENDREC 


jedoch nur, wenn ohne Verteilcodes gearbeitet wird 
(ATTR=(SHARE,NDISCO) oder NSHARE). 
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Beim Empfang einer Transportquittung wird dieser Орегапа nicht ausgewertet. 


YRECEIVE (mit OPTCD=SPEC) ist nicht zulässig, wenn der Partner im CS-Zustand ist und ein 
YRECEIVE-Aufruf mit OPTCD=(SPEC,CA) noch unerledigt ist. 


YRECEIVE (mit OPTCD=SPEC) ist nicht zulässig, wenn sich der Partner im CA-Zustand 
befindet. | 


YSEND (mit OPTCD = СА) ist nicht zulässig, wenn sich der Partner im CS-Zustand befindet 
und für diesen noch YRECEIVE-Aufrufe unerledigt sind oder die blockweise Eingabe nicht 
abgeschlossen ist. 


YSEND (mit OPTCD = CS) ist nicht zulässig, wenn sich der Partner im CA-Zustand befindet 
und Umschalten auf den CS-Zustand gerade stattfindet. 


Hinweis: 


DCAM kann die CS-/CA-Option ignorieren, wenn eine Eingabe vom Terminal blockweise 
erfolgt. 


Solange die Eingabe nicht abgeschlossen ist, wird der Kommunikationspartner in den 
CS-Zustand versetzt. 


Erst nach Beendigung der Eingabe ist die CS-/CA-Option des YRECEIVE wirksam (siehe 4.18). 


ELEMENT 
ОРТСО-- SUBGROUP 
GROUP 


ELEMENT Die Daten sind Element einer Gruppe oder Untergruppe von Daten. 
SUBGROUP Die Daten sind das letzte Element einer Unter-Gruppe von Daten. 
GROUP Die Daten sind das letzte Element einer Gruppe von Daten. 


Ist der Partner eine DCAM-Anwendung, erhält er sie als Angabe in FDB4 der Rückmeldung 
(siehe Anhang А.2). 


Bei EDIT=USER stellt DCAM nur sicher, daß die Information über die Datenstufe (Block, 
letzter Block einer Nachricht, letzter Block der Übertragung) mit gesendet wird. 
Falls möglich, wird diese Angabe in die Kontroll-Information für Terminals eingetragen. 


Bei EDIT=SYSTEM übernimmt es DCAM, die Nachricht für den Anwender, falls erforderlich, 
in Teilstücken auszugeben. 


Dieser Operand wird von DCAM ausgewertet bei: 


. — YSEND 


— YSENDREC 


NORMAL 
OPTCD= 
EXPRESS 


NORMAL Die zu sendende Nachricht hat normale Priorität. 


EXPRESS Die zu sendende Nachricht hat Expreß-(höchste) Priorität, ist im Datenkom- 
munikationssystem mit hoher Priorität zu transportieren und dem Partner 
sofort (ggf. mit asynchroner EXPR-Meldung) zu übergeben. 
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Der Operand wird von DCAM ausgewertet bei: 


ç — YSEND 


— YSENDREC 


jedoch nur, wenn die Verbindung (CCB) mit EDIT=USER beschrieben wurde. Ansonsten 
werden alle Nachrichten mit gleicher Priorität behandelt. 


Anmerkungen: 


Expreß-Nachrichten sollten nur in Ausnahmefällen gesendet werden. 

DCAM signalisiert eine Überlastung der Verbindung (Wait for Go), wenn eine Expreß-Nach- 
richt gesendet wird, bevor eine vorangehende Expreß-Nachricht im System des Kommunika- 
tionspartners eingetroffen ist (siehe YCCB: PROC=SIGNAL/NSIGNAL). 


Die Nachrichtenflußsteuerung (Wait for Go - Go-Signal) arbeitet unabhängig sowohl für 
normale als auch für Expreßnachrichten. 


а 
OPTCD- 
на 


о Ein Makroaufruf, der sich auf diesen RPB-Steuerblock bezieht, wird іп eine 
© Warteschlange eingereiht, wenn der Aufruf nicht sofort beendet werden 
kann. 


Dies kann auftreten bei: 
— YRECEIVE, wenn auf die Ankunft von Daten gewartet werden muß. 


— YOPNCON (OPTCD=ACCEPT), wenn auf eine Aufforderung ` zum Ver- 
bindungsaufbau gewartet werden muß. 


NO Ein Makroaufruf, der sich auf diesen RPB-Steuerblock bezieht, wird nicht in 
eine Warteschlange eingereiht, wenn der Aufruf nicht sofort beendet 
werden kann. 


Dieser Operand wird von DCAM ausgewertet bei: 


YOPNCON 
YRECEIVE 
YSENDREC 


Die Angabe OPTCD = О ist obligatorisch, wenn gleichzeitig OPTCD=ASY gesetzt wird. 


REQLOGON 
© TOPLOGON 
NAMXLATE 
OPTCD=+ COUNTPTN 
APPSTAT 
CIDXLATE 
PTNCHAR 
Die Art des YINQUIRE-Aufrufs wird festgelegt. 
REQLOGON Es sollen Informationen ober den zum Verbindungsaufbau auf- 
auffordernden Partner gegeben werden. 
TOPLOGON 
NAMXLATE Partner- und Prozessornamen sollen in das Kennzeichen der Verbindung 
(CID) übersetzt werden. 
COUNTPTN Es wird die Anzahl der verbundenen Partner und die Anzahl der zum 


Verbindungsaufbau auffordernden Partner abgefragt. 
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APPSTAT Es werden Informationen darüber abgefragt, ob eine Anwendung eröffnet 
ist oder nicht und ob sie sich im START- oder STOP-Zustand befindet. 


CIDXLATE Ein Verbindungskennzeichen (CID) soll in den Partner- und Prozessornamen 
übersetzt werden. 


PTNCHAR Es werden die Charakteristika eines Partners abgefragt. 


Dieser Operand wird von DCAM ausgewertet bei: 


— YINQUIRE 
SPEC 
OPTCD= 
ANY 
SPEC Ein YOPNCON (mit ОРТСО = ACCEPT), YRECEIVE- oder YRESET-Makroauf- 
ruf wird auf einen spezifischen Partner bezogen. 
ANY Ein YOPNCON (mit OPTCD = ACCEPT), YRECEIVE- oder YRESET-Makroauf- 


ruf wird auf einen beliebigen Partner bezogen. 
Dieser Operand wird von DCAM ausgewertet bei: 


YOPNCON mit OPTCD=ACCEPT, wenn im ACB-Steuerblock, der die DCAM-Anwendung 
beschreibt, ATTR=LOGON gesetzt wurde. 

YRECEIVE 

YRESET 

YSENDREC 


START 
OPTCD= 


STOP 

START Der Zustand der DCAM-Anwendung wird auf START gesetzt. 
STOP Der Zustand der DCAM-Anwendung wird auf STOP gesetzt. 
Dieser Operand wird von DCAM ausgewertet bei: 

— YSETLOG, jedoch nur, wenn die Anwendung mit ATTR=LOGON eröffnet wurde. 


Der Zustand gibt an, ob Aufforderungen zum Verbindungsaufbau bearbeitet werden (START) 
oder nicht (STOP). 


Nach YOPEN, vor der ersten Abgabe eines YSETLOG, ist der START-Zustand eingestellt. 
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SYN 
OPTCD= 


ASY 
SYN Die Steuerung des Programmablaufs wird nach der Beendigung des Makro- 
aufrufs und Ausführung des enthaltenen Befehls an den Benutzer zurückge- 
geben. | 
ASY Die Steuerung des Programmablaufs wird nach der Annahme des Makro- 


aufrufs durch DCAM an den Benutzer zurückgegeben. Nach Ausführung 
des enthaltenen Befehls wird durch DCAM eine vom Benutzer bestimmte 
Meldung für ein Ereigniskennzeichen (EID) gegeben. In diesem Fall muß 
auch OPTCD = Q und EID = relexp gesetzt werden. 


Dieser Operand wird von DCAM ausgewertet bei: 


_ YOPNCON 
_ YRECEIVE 
YSENDREC 
TACK 
OPTCD= 
NTACK 
TACK Es wird eine Transportquittung für Nachrichten verlangt, die mit YSEND 
oder YSENDREC gesendet werden. 
NTACK Es wird keine Transportquittung für Nachrichten verlangt, die mit YSEND 


oder YSENDREC gesendet werden. 
Der Operand wird von DCAM ausgewertet bei: 


— YSEND 
— YSENDREC 


Eine Transportquittung kann positiv oder negativ sein. Das bedeutet: 


— bei Datenstationen als Empfänger den ordnungsgemäßen oder nicht ordnungsgemäßen 
Abschluß der Datenübertragungsprozedur; 


— bei Prozessen als Empfänger, daß der Empfang einer Nachricht mit den Aufrufen YRE- 
CEIVE bzw. YSENDREC ordnungsgemäß oder nicht ordnungsgemäß ablief. 


Wenn eine TACK-Contingency-Routine definiert worden ist, ergibt sich die Art der Quittung 
(positiv oder negativ) aus dem Inhalt von Register 6. 


Ist keine TACK-Contingency-Routine definiert worden, so kann die Art der (mit YRECEIVE 
empfangenen) Quittung in FDB4 des Rückmeldefeldes gefunden werden (siehe Anhang A.2). 
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TRUNC 
OPTCD=} KEEP 
ССВТК 


TRUNC Wenn die Nachricht eine Länge hat, die die Länge des im Empfangsmakro- 
aufruf angegebenen Empfangsbereiches AAREALN überschreitet, wird der 
überlange Teil abgeschnitten und gelöscht. Der Empfangsaufruf wird 
erfolgreich beendet. Es wird jedoch im FDBK-Feld (siehe Anhang A.2) des 
RPB-Steuerblocks, auf den sich der Empfangsaufruf bezieht, der Daten- 
überlauf angezeigt. Im ARECLN-Feld (siehe Anhang A.1) desselben Steuer- 
blocks wird die Länge des Datenrestes angezeigt. 


KEEP Wenn die Nachricht eine Länge hat, die die Länge des im Empfangsmakro- 
aufruf angegebenen Empfangsbereichs überschreitet, wird der überlange 
Teil für einen nachfolgenden YRECEIVE (OPTCD=SPEC) aufgehoben. 


Der Empfangsaufruf wird erfolgreich beendet. Es wird jedoch im RPB- 
Steuerblock, auf den sich der Aufruf bezieht, im FDBK-Feld (siehe Anhang 
A.2) angezeigt, daß die Restdaten aufgehoben werden. Im ARECLN-FELD 
(siehe Anhang A.1) desselben Steuerblocks wird die Länge des Datenrestes 
angezeigt. 


CCBTK Es gilt der im PROC-Operanden des CCB-Steuerblocks angegebene Wert: 
TRUNC oder KEEP. 


Der Operand wird von DCAM ausgewertet bei: 


YRECEIVE 
YSENDREC 


jedoch nur, wenn ein Datenüberlauf eintritt. Bei Abweichung haben hier getroffene Angaben 
Vorrang vor denen im CCB. 


In einfach benutzbaren DCAM-Anwendungen oder in mehrfach benutzbaren DCAM-Anwen- 
dungen mit ATTR=NDISCO wird die KEEP-Funktion nur ausgeführt, wenn der Partner im 
CS-Zustand ist oder vom Empfangsmakroaufruf, der den ersten Teil der Nachricht empfangen 
hat, in den CS-Zustand versetzt wird. 


Der Rest der Nachricht kann nur mit einem YRECEIVE (OPTCD = SPEC)-Makroaufruf empfan- 
gen werden, der von dem Prozeß ausgegeben wird, der den CS-Zustand verursachte. Wenn 
dieser Prozeß vorher beendet wird, geht der Rest der Nachricht verloren. 


In DCAM-Anwendungen тії ATTR=DISCO wird der Rest der Nachricht mit dem nächsten 
YRECEIVE (OPTCD=SPEC)-Makroaufruf empfangen werden, der von irgendeinem Prozeß 
der DCAM-Anwendung ausgegeben wird. 
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SEQNO=absexp 


Es wird der zu sendenden Nachricht die hier angegebene Nummer zugeordnet. 
Der Standardwert ist 0, der Maximalwert ist 65535. Dieser Operand wird von DCAM ausgewer- 
tet bei: 


YSEND 
YSENDREC 


Hinweis: 


Die Laufnummer kann auch durch ein Register versorgt werden, wenn die Registernummer 
direkt beim YSEND angegeben wird: 


YSEND...,SEQNO = (register),... 


Die Zuordnung einer Nachricht zu der dazugehörigen Transportquittung wird über diese 
Nummer hergestellt. Die Nummer wird, wenn eine TACK-Contingency-Routine definiert 
worden ist, im Register 7 übergeben. Andernfalls kann die Nummer beim Empfang der 
Quittung im TACKNO-Feld (siehe Anhang A.1) des RPB-Steuerblocks, auf den sich der 
Empfangsaufruf bezieht, abgeholt werden. 


Die Nummer der Nachricht kann vom Partner im ASEQNO-Feld (siehe Anhang A.1) des 
RPB-Steuerblocks, auf den sich der Empfangsaufruf bezieht, abgeholt werden. Dort steht 
entweder die im БЕОМО-Орегапдеп angegebene Nummer (DCAM-Anwendung) oder eine 
vom Datenkommunikationssystem erzeugte, wenn der Absender eine Datenstation war. 


TOVAL=absexp 


Gibt die Zeit an, die ein Makroaufruf, der nicht sofort bearbeitet werden kann, in einer 
Warteschlange aufgehoben wird. 


Der Wert wird in Sekunden angegeben. 

Der Standardwert ist 600. 

Der maximale Wert ist 32767. 

Die Angabe des Wertes Null bedeutet unbegrenzte Wartezeit. 
Die Genauigkeit der Überwachung liegt im Sekundenbereich. 
Dieser Operand wird von DCAM ausgewertet bei: 


YOPNCON mit ОРТСП-АССЕРТ 
YRECEIVE 
YSENDREC 


jedoch nur, wenn OPTCD = О ebenfalls gesetzt wurde. 
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4.22 


YSEND 


Funktion 


Mit diesem Aufruf wird das Übertragen (Senden) von Daten aus dem Benutzerbereich in den 
Datenspeicher des Kommunikationssystems eingeleitet. Es können Normal- und Expreßnach- 
richten gesendet werden (siehe auch 3.3.1). 


Format 
Name Operanden 
[symbol] YSEND RPB=addr 
[,schlüsselwort=neuer wert,...] 
Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 


schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


DCAM М8.0А ОСАМ Makroaufrufe, 0987-.)-275-2 


YSEND 


Folgende Angaben sind bei der Beschreibung des YSEND von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 

AID (register) 

CCB addr 

CID (register) 

AREA addr 

AREALN value 

OPTCD NORMAL 
койо, 


ТАСК 
2 
NTACK 
CS 
(e 
СА 


ELEMENT 
[ , 1 SUBGROUP |] 


GROUP 
BELL 
® ] 
NBELL 
SEONO value 
EID addr 
EIDREF information 
(register) 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Hinweis 


Wenn der Nachrichtenfluß (mit normaler oder Expreß-Priorität) sich auf einer Verbindung 
gestaut hat, wird dem sendenden Prozeß für jeweils den ersten YSEND-Aufruf (normale 
Nachrichten; Expreßnachrichten) die Rückmeldung “Wait for Go” zurückgegeben. Bevor ein 
entsprechendes Go-Signal (Eintrag für das Ereigniskennzeichen EID) gegeben wurde, führen 
weitere YSEND-Aufrufe durch diesen Prozeß auf derselben Verbindung zu der Rückmeldung 
"BCAM: Mangel an Speicherplatz”. 
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Weitere Prozesse, die auf einer überlasteten Verbindung zu senden versuchen, werden genau 
so wie der zuerst sendende Prozeß behandelt. 


Bei der Rückmeldung “Wait for Go” wird der Anforderungsparameter-Block (RPB) gesperrt, 
bis ein Go-Signal gegeben ist. DCAM trägt in diesen RPB die FDBK-Information für das 
Go-Signal ein (siehe A.2 Rückmeldungen: ҒОВ4). 


Sobald die Überlastung der Verbindung behoben ist, wird ein Go-Signal jedem Prozeß 
zugestellt, der ein "Wait for Go” erhalten hat. 


Ein Go-Signal garantiert dem nächsten YSEND-Aufruf keinen Erfolg. 


Falls eine Verbindung oder Anwendung geschlossen wird, wird ein Go-Signal jedem Prozeß 
zugestellt, der eines für die betroffene Verbindung erwartet. 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe auch 3.3.1) und der Tabelle der 
Meldungen zu entnehmen (Anhang А.2). 
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YSENDREC 


YSENDREC 


Funktion 


Mit diesem Aufruf werden die Funktionen des YSEND und YRECEIVE kombiniert angefordert 
(siehe auch 3.3.3). 


Es werden Daten zu einem bestimmten Partner gesendet und von diesem werden anschlie- 
Bend Daten erwartet. 


Format 


Name Operanden 


[symbol] | YSENDREC RPB=addr 


[,schlüsselwort=neuer wert, . . . ] 


Operanden 

RPB=addr 

Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YSENDREC von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 

AID (register) 
CCB addr 

CID (register) 
AREA addr 
AREALN value 
AAREA addr 
AAREALN value 
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schlüsselwort neuer wert 


OPTCD а 
1 
на 


ELEMENT | 
] 


EID addr 

EIDREF information 
wer, | 

TOVAL value 


ЅЕОМО value 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.1). 


Hinweis 


Jeder Fehler, der beim Senden der Daten auftritt, beendet den YSENDREC Aufruf und gibt 
einen entsprechenden Returncode zurück. Beispielsweise kann bei einer Überlastung der 
Verbindung ein "wait for до” gegeben werden; das Empfangen von Daten wird dann nicht 
mehr eingeleitet. 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe 3.3.3) und der Tabelle der Meldungen 
zu entnehmen (Anhang А.2). | 
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YSETLOG 


YSETLOG 


Funktion 


Dieser Aufruf veranlaßt die Änderung des Zustands einer DCAM-Anwendung. Es kann der 
START- in den STOP-Zustand und der STOP- in den START-Zustand geändert werden (siehe 
auch 3.1.2). 


Der Aufruf kann nur in einem Primärprozeß gegeben werden. 


Format 
Name Operanden 
[symbol] YSETLOG RPB=addr 
[,schlüsselwort=neuer wert,...] 
Operanden 
RPB=addr 


Adresse des RPB-Steuerblocks, der den Makroaufruf beschreibt. 
schlüsselwort = neuer wert 


Hiermit können Werte des RPB-Steuerblocks wie auch mit dem Aufruf YMODCB aktualisiert 
werden. 


Folgende Angaben sind bei der Bearbeitung des YSETLOG von Bedeutung: 


schlüsselwort neuer wert 


ACB addr 

AID (register) 

OPTCD START 
іше | 


Zur Beschreibung der einzelnen Felder siehe YRPB (4.21) und die Tabelle der Steuerblockfel- 
der (Anhang A.2). 


Rückmeldung 


Die Rückmeldung ist der Funktionsbeschreibung (siehe auch 3.1.2) und der Tabelle der 
Meldungen (Anhang A.2) zu entnehmen. 
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4.25 


YSHOWCB 


Funktion 


Mit dem YSHOWCB-Makroaufruf werden die Inhalte von einem oder mehreren ACB-, CCB-, 
DIP-, ENB- oder RPB-Feldern in einen vom Benutzer bestimmten Bereich übertragen. Mit 
einem YSHOWCB-Aufruf können nur die Felder von jeweils einem bestimmten Steuerblock 
übertragen werden (in der Reihenfolge, wie sie im FIELDS-Operanden angegeben wurden). 
Die erforderliche Länge des Bereiches ist der Tabelle der Steuerblockfelder zu entnehmen. Ist 
der Benutzerbereich zu kurz, um alle Felder aufzunehmen, trägt DCAM einen Fehlercode in 
Register 15 ein und hinterlegt die erforderliche Länge im Register 0. 


Format 
Name Operanden 
[symbol] YSHOWCB ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 
‚BLKADDR=addr 
‚WAREA=addr 
‚LENGTH=value 
L 
[,MF= ] 
(E,addr) 
schlüsselwort 
‚FIELDS= 
(schlüsselwort,....) 
Operanden 
ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 


Gibt den Typ des Steuerblocks an, aus dem Felder gelesen werden sollen. 


BLKADDR=addr 
Gibt die Adresse des Steuerblocks an, dessen Felder mit YSHOWCB behandelt werden sollen. 
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WAREA=addr 


Gibt die Adresse des Speicherbereiches im Benutzerprogramm an, wohin die Steuerblockfel- 
der übertragen werden sollen. 


Dieser Bereich muß an einer Wortgrenze beginnen. 


LENGTH=wert 
Gibt die Länge des durch den WAREA-Operand bestimmten Bereiches an. 


L 
e 
(E, addr) 


Gibt die Form des Makroaufrufs an (siehe 2.1.2). 


schlüsselwort 
FIELDS= 
(schlüsselwort, ...) 


Gibt eines oder mehrere Steuerblockfelder an, deren Inhalt(e) übertragen werden sollen. Die 
Namen der Felder sind der entsprechenden Tabelle (siehe Anhang A.1) zu entnehmen. 
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Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register Bedingungen 


0 Länge des im Der in LENGTH angegebene Wert ist 
Benutzerbereich |zu klein 
benötigten 
Speichers 
15 YSHOWCB wurde erfolgreich durch- 
geführt. 
links- Die in BLKADDR angegebene Adresse 
bündig ist keine Steuerblockadresse. 


Obligatorischer Operand fehlt. 


Die Länge des Speicherbereiches, 
in den die Feldinhalte einge- 
schrieben werden sollten, ist zu 
klein. Die benötigte Länge steht 
im Register 0. 


Der Steuerblock, dessen Adresse 
durch BLKADDR angegeben wurde, 
ist nicht von der Art, die in BLK 
angegeben wurde. 


Das Steuerblockfeld ist keines 
des angegebenen Steuerblocks. 


Die Adresse im MF-Operanden ver- 
weist nicht auf eine L-Form- 
Operandenliste. 


Die Adresse des Benutzerbereichs ist 
ungültig. 


Ungültige Parameterliste oder 
Registernummer. 


Für die Inhalte von Register 15 können mit dem Makroaufruf YDDFDB (siehe Anhang А.7) 
symbolische Adressen generiert werden. 
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YTESTCB 


4.26 YTESTCB 


Funktion 


Mit dem YTESTCB-Makroaufruf wird der Inhalt eines bestimmten ACB-, CCB-, DCG-, DIP-, 
ENB- oder RPB-Steuerblockfeldes mit einem vom Benutzer vorgegebenen Testwert vergli- 
chen. Der von YTESTCB durchgeführte Vergleich ist ein logischer Vergleich. Das Ergebnis 
wird dem Benutzer im Register 0 übergeben. (Aktueller Wert А; Testwert В; 0 wenn А = B, < 
Owenn А < Bund > 0 wenn A > В). 


g ZP 
Name Operanden 


[symbol] | YTESTCB ACB 


‚BLKADDR=addr 


|,ЕВЕТ-аааг | 


5 
мат 
(E,addr) 


i ‚schlüsselwort=testwert 


Operanden 


Gibt den Typ des Steuerblocks an, dessen Feld getestet werden soll. 
BLKADDR=addr 

Gibt die Adresse des Steuerblocks an. 

ERET=addr 


Gibt die Ansprungadresse einer vom Benutzer zu bestimmenden Fehlerroutine an. Sie soll 
ablaufen, wenn der YTESTCB nicht oder nicht vollständig ausgeführt werden kann. Das 
Register 0 enthält in einem solchen Fehlerfall keine sinnvollen Werte. 


L 
| | 
(E,addr) 


Gibt die Form des Makroaufrufs an (siehe 2.1.2). 
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schlüsselwort = testwert 


Gibt das Steuerblockfeld (schlüsselwort) an, das mit dem bestimmten Wert (testwert) 
verglichen werden soll. 


Der Name der Steuerblockfelder und die Testwerte sind aus der entsprechenden Tabelle zu 
entnehmen (siehe Anhang А.1). 


Rückmeldung 


Von DCAM zurückgegebene Informationen: 


Register |Rückinformation |Bedingungen 


0 (sedezimal 
verschlüsselt) 


>: 0 Der aktuelle Wert im Steuerblock- 
feld ist größer als der vom Be- 
nutzer vorgegebene Wert. 


Der aktuelle Wert ist kleiner als 
der vom Benutzer gegebene. 


Der aktuelle Wert ist gleich dem 
vom Benutzer gegebenen. 


Register |Rückinformation |Bedingungen 


15 YTESTCB wurde erfolgreich durch- 
geführt. 
links- 
bündig Die im BLKADDR angegebene Adresse 


ist keine Steuerblockadresse. 
Obligatorischer Operand fehlt. 
Ungültige ERET-Adresse 


Der Steuerblock, dessen Adresse 
durch BLKADDR angegeben wurde, 
ist nicht von der in BLK angege- 
benen Art. 


Das Steuerblock-Feld ist keines 
des angegebenen Steuerblocks. 


Die Adresse im MF-Operanden ver- 
weist nicht auf eine L-Form- 
Operandenliste. 


Die Adresse des Steuerblocks 
ist ungültig. 


Ungültige Parameterliste oder 
Registernummer 


Für die Inhalte von Register 15 können mit dem Makroaufruf YDDFDB (siehe Anhang A.7) 
symbolische Adressen generiert werden. 
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А Anhang 


A.1 Tabelle der Steuerblockfelder 


Die folgende Tabelle faßt alle Steuerblockfelder zusammen, die durch Steuerblock- oder 
Aktionsaufrufe belegbar bzw. veränderbar sind. 

Es wird der Wert oder der mnemotechnische Wert, der für das jeweilige Feld benutzt werden 
kann, angegeben. 

Für den Aufruf YSHOWCB ist die erforderliche Länge des Benutzerbereichs für jedes mit 
YSHOWCB behandelbare Feld angegeben (in Bytes). 


Die mnemotechnischen Werte 

— value und 

— addr 

in den im folgenden angegebenen Feldern erlauben auch eine Registerangabe. 


Schlüssel- 
wort des 
Steuer- 
block 
feldes 


Erklärung 


Anwendungsname 
Adresse |Verteilungsname 
von Ereignis- 
Meldungsblock 
Kettungsname 
Symbolischer 
Prozessorname 


Übernahme des 
CLT-Eintrags 


LINKMOD 
КЕ 
VERIFY 


SHARE 


DISCO Eigenschaften der 


DCAM-Anwendung 


statischen 
PERM 
ші 

Д 


Wert oder mnemotechnischer Wert 

Makro-Auf- а 

ruf zur YGENCB YMODCB YTESTCB ü 

Steuerblock- 

erzeugung 

А EE 
PRIMTASK LOGON 

(| ] [,+REQTASK il, ]) 
NOTACK NLOGON 

NO 

PRIMARY 

SECONDARY 


NSHARE NDISCO 


Prüfangabe 


Anwendungskennwort (Vorgabe) 
Anwendungskennwort (Angabe) 
Verbindungskennwort (Vorgabe) 


kennwort kennwort 


kennwort 


| 


Pr 


Kennzeichen der 
DCAM-Anwendung 


g” Rückmelde-Feld 
ЕСЕ Länge des ACB-Steuerblocks 
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Schlüssel- Wert oder mnemotechnischer Wert 


Steuer-|wort des 

block |Steuer- Erklärung 
block 
feldes 


Makro-Auf- 

ruf zur YGENCB YMODCB YTESTCB 

statischen YSHOWCB 

Steuerblock- 

erzeugung 
Kettungsname 

relexp addr addr addr Adresse |Prozessorname 

von Partnername 

Verteilungs- 
parameter-Block 


absexp value value value Maximale Länge der Nach- 
richt auf dieser Verbindung 
LINKMOD PERM Übernahme der 
CLT-Einträge 
TEMP 
USERFLD benutzerfeld| [benutzer- benutzer- benutzer- Begleitinformation 
feld feld feld 
(register) (register) (register) 


der Verbindung 


Verbindungskennwort 
(Angabe) 


Datenübermittlungs- 
protokoll 


Nachrichtenaufbereitung 


EDIT USER 
SYSTEM 
EDITIN PHYS 


бЕТЕС LCASE 
{шк М N 1 l 1 d 
FORM НЄЕТЕС| |МІСА5Е 
u 


GETBS Aufbereitung der 


Nachrichteneingabe 


NGETBS 


Aufbereitung der 
Nachrichtenausgabe 


HCOPY HOM EXTEND 
182277 cia, 


SYSCODE Wünsche zur 


Übergabeprozedur 


Kennzeichen der 
Nachrichtenverteilung - | 


APPSTART SIGNAL 
, , ) 
d Belt Kai 


Partnercharakteristika ә 
Те11 1 

Vom Partner vorgeschlagenes 
Datenübermittlungsprotokoll 


Vom Partner vorgeschlagene 
Nachrichtenaufbereitung 


Vom Partner vorgeschlagener 
Beginn der Daten- 
übermittlung 


Markierung für die 
Belegung des Steuerblocks 
durch einen Aufruf 
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Schlüssel- 
wort des 


Wert oder mnemotechnischer Wert 


YGENCB YMODCB ҮТЕЗТСВ . 


Makro-Auf- 
ruf zur 
statischen 
Steuerblock- 
erzeugung 


(codevalue,....) 
CODELN absexp value value value 
CODEPOS 


Хэв ® ыы ЗА Ee 


tragen 


Adres- 
se des 
Kenn- 
zei- 
chens 
der 


1) Rechtsbündiges Byte 
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Erklärung 


max. 8 Verteilcodewerte 
(jeder in einem Feld von 
8 Bytes linksbündig einge- 


Kennzeichen der Verteil- 
Codegruppe (0С6) 

Länge des Verteilcode- 
gruppen-Blocks 


Länge des Verteilcodes 
Position des Verteilcodes 


Anzeige für 

impliziten Verteilcode 
max. 16 Adressen von 
DCG-Steuerblöcken 
Kennzeichen der 
Nachrichtenverteilung 


Länge des DIP-Steuerblocks 


Länge des ENB-Steuerblocks 


LOGON 

LOSCON- 

PROCON-| Contingency 
COMEND- Routine 
EXPR- 

TACK- 

SECOND- 


A1-3 


Schlüssel- 


Wert oder mnemotechnischer Wert 


Steuer-|wort des 
block |Steuer- Makro-Auf- Erklärung 
block ruf zur YGENCB YMODCB YTESTCB 
feldes statischen 
Steuerblock- 
erzeugung 
RPB ACB-Steuerblock 


Adres- |CCB-Steuerblock 

se Pufferbereich 

von: alternativer Puffer- 
ber. Ereignis- 

kennzeichen 


re 
absexp value value 
absexp/ 

(register) 


information очо (ation 


Länge des Pufferbereiches 
Länge der alternativen 
Pufferbereiches 
Zeitintervall für Warte- 
schlangeneinreihung von Ma- 
Makroaufrufen 

fortlaufende Nummer der zu 
sendenden Nachricht 


Benutzereigene Information 
nach Beendigung eines 
asynchronen Aufrufs 


mation 
(register) 


mation mation 
(register) (register) 


ACCEPT CS] [ELEMENT NORMAL 
1 d esch, | 
ACQUIRE] [CA] (GROUP EXPRESS 


REQLOGON 
TOPLOGON 
а NAMXLATE| [SPEC] [START 
1 d COUNPTN М d N 
APPSTAT ANY STOP 
CIDXLATE 


PTNCHAR 
SYN) [TACK TRUNC] [BELL 
d d КЕЕР d d 
ASY] |МТАСК) | Leem) |МВЕШ 


(register) (register) (register) Kennzeichen der Aufforderung 
zum Verbindungsaufbau 

(register) (register) (register) Kennzeichen d. DCAM-Anwendg. 
Kennzeichen der Verbindung 


Länge der im alternativen 
Pufferbereich eingeschrie- 
benen Daten bzw. Länge des 
Rests, wenn die Nachricht 
die Pufferlänge überschrei- 
tet. 

fortlaufende Nummer der 
empfangenen Nachricht. 
fortlaufende Nummer der 
empfangenen 
Transportquittung 


Anforderungskennungen 


—U 


Пан 
ка 
oO 


benutzer- 
feld 
(register) 


Begleitinformation der Ver- 
bindung, wie im CCB angege- 


Markierung für die Bele- 
gung des Steuerblocks durch 
einen Aufruf 


er Länge des RPB-Steuerblocks 


1) Name des Makro-Aufrufs ohne vorangestelltes Zeichen ’Y’ 
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Tabelle der Rückmeldungen 


Das Rückmeldefeld befindet sich im RPB- bzw. ACB-Steuerblock und ist mit 'FDBK’ bezeich- 
net. Es hat eine Länge von 4 Bytes: 


Datenanzeigen 


Anzeigen 
Grund der Zurückweisung (error code) 
Zusammenfassung der Rückmeldung (summary) 


Die Eintragung erfolgt sedezimal. 


Für die Inhalte können symbolische Adressen generiert werden (Makroaufruf YDDFDB, 
Anhang A.7). 


Die Rückmeldung wird ebenfalls in Register 15 zur Verfügung gestellt. 


Wenn der ACB- oder RPB-Steuerblock nicht mehr adressierbar ist, wird die Rückmeldung nur 
in Register 15 zur Verfügung gestellt. 


Bei asynchroner Ausführung eines Befehls enthält Register 15 u.U. nur Angaben über die 
Annahme oder Nichtannahme des Befehls (siehe auch die folgende Tabelle). 


Steuerblock 


ШИГ: ин 


Register | Register 
15 15- 3) 


ma [шш | | 
KRA > 
кыру. „> > 
СЫ Ге 


1) Der Wartezustand kann von einer Contingency unterbrochen werden; daher ist es 
möglich, daß der Steuerblock vom Benutzer zerstört wurde. 


Rückmeldung 
FDBK in 
ACB/RPB 


Ausführung 
bestätigt? 


Stand der 
Anforderung 


Synchroner Aufruf 
sofort zurückgewiesen 


sofort ausgeführt 


nach einer Wartezeit zu- 
rückgewiesen/ausgeführt 


Asynchroner Aufruf 
sofort zurückgewiesen 


angenommen und sofort 
ausgeführt 


nach einer Wartezeit zu- 
rückgewiesen/ausgeführt 


2) Der Benutzer erhält die Steuerung bevor der Aufruf ausgeführt wurde, daher ist es 
möglich, daß der Steuerblock vom Benutzer zerstört wurde. Es kann keine Rückmeldung 
erhalten und den ungültigen Steuerblock auch nicht später mit YSHOWCB oder YTESTCB 
ansprechen. 


3) linksbündiges Byte. 


4) X'00' = "angenommen”. 
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Bee 


nur bei YOPEN- 
Makroaufruf 


reich aus- 
geführt 


Erfolg- 
reich aus- 
geführt 


|Primär-/ 
| Sekundär | 
prozeß 


nur bei YSENDREC und 
YRECEIVE 


Anzeige: 
|Länge der 
"| Nachricht 


Erfolg- 
reich aus- 
geführt 


nur bei asynchronen 
YOPNCON, YRECEIVE 
und YSENDREC 


angenommen 


verursacht durch den 
Zustand der DCAM- 
Anwendung 


verursacht durch den 
Zustand des Partners 


verursacht durch den 
Zustand des Daten- 
übertragungssystems 


zurückge- |unzulässiger Gebrauch | 
wiesen eines Makroaufrufs 
zurückge- |falsche Parameter im 
wiesen Makroaufruf 


Zustand [Bemerkung 
des Makro- 
aufrufs 


zurückge- 
wiesen 


zurückge- 
wiesen 


zurückge- 
wiesen 


zurückge- |falsche Adressierung 
wiesen oder Registerangabe 
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Makroaufruf 


Rückmelde-Feld Bedeutung 


Makroaufruf erfolgreich 
beendet 


| 
E! 
| 


Шыға О ШИНЕ EE тесе; сэг х ислэг лал ET WERE NORD FERIEN SEA 
— Бе ле ы [зс i фе k Gi к L ЛЫ АЯ s үс 8 
Ween Ba DENE DEER шер, BEE AR жа ЕР ГЫШЫН FE ET ҒЫ» AR 5 ТЕСТА EM 


Prozeß 15%. 
Primärprozeß der 

DCAM- 
Prozeß ist Anwendung 
Sekundärprozeß 


00 Nachricht überschreitet 
| = | nicht die Pufferlänge 
04 | Nachricht überschreitet —Ç 

| Pufferlänge; Uberlànge ist gelöscht 


08 |. Nachricht überschreitet Pufferlänge; 

| Uberlànge ist aufbewahrt; Länge des Restes 
ist im ARECLN-Feld des RPB-Steuerblocks 
hinterlegt 


Nachricht 


Go-Signal 


-1| Transportquittung : 
N -positiv E 


1 Transportquittung 
- negativ 


Express-Nachricht 


Element 
u Daten- 
Untergruppe +} gruppierung 


Gruppe 


| Makroaufruf angenommen 
ee S 


А2-3 


А2-4 


| Makroaufruf mit Warnung 

| beendet 
Widersprüche in der Datenverschlüsselung 
(BINARY/SYSCODE) 


wie für FDB1=X’00' 


keine Eingabedaten vorhanden 

| (OPTCD=NQ) 
| keine Aufforderung zum Verbindungsaufbau in der 
| Warteschlange 


| Makroaufruf beendet wegen Zeitablauf (TOVAL) 


| Verlust von Daten wegen (System) Zeitablauf 
| oder weil die Nachricht als gestört 
gekennzeichnet war. 


04 — zu 


—— emm 


In einer Warteschlange stehende Aufforderung 
zum Verbindungsaufbau annulliert wegen 
| (System) Zeitablauf 


Verbindungs-Nachricht abgeschnitten _ 
Fehler in der Nachrichtenaufbereitung 


| Partnercharakteristik nicht vollständig 
| übergeben 
Ausgabe wurde gekürzt (aufbereitete Nachricht 
war zu lang) 
Ungültige Angaben für Nachrichtenaufbereitung 
(Änderung wurde nicht ausgeführt) 


Aufruf beendet durch YRESET 
оо Kein Drucker für Datenausgabe betriebsbereit 


! : Unzulässiges Kontrollzeichen (NL) wurde einge- 
2 geben (bei EXTEND) 


DCAM М8.0А ОСАМ Makroaufrufe, U987-J-Z75-2 


ү 
5 С n 
ІШЕ 
NS, 
EICH 


Makroaufruf zurückgewiesen wegen des 
| aktuellen Zustands der DCAM-Anwendung 


Die DCAM-Anwendung ist von dem aufrufenden x 
| Prozeß nicht eröffnet (ungültiges АШ). 


| Die DCAM-Anwendung ist schon eröffnet 
| (ATTR=NSHARE ist gesetzt). 


Die DCAM-Anwendung ist schon eröffnet. x 
© | Sie ist nur einfach verwendbar. 


Die DCAM-Anwendung ist bereits durch den an- 
| fordernden Prozeß eröffnet worden. 


Die DCAM-Anwendung ist schon eröffnet 
(VERIFY=PRIMARY ist gesetzt). 


Die DCAM-Anwendung ist nicht eröffnet 
cl (VERIFY=SECONDARY ist gesetzt). 


Verteilungsname/Verteilcodes sind schon 
zugelassen 


Warnung: Erzwungene Beendigung der DCAM- — — — — — 
| Anwendung ЕЕЕ Е 


Б НШЫ» ыы AST E Ee 


а Ж Оол аи рате а ISI N LOOL ы Л аршу еи < 


Erzwungene Beendigung дег DCAM-Anwendung 


Erzwungene Beendigung der DCAM-Anwendung 
| wegen eines DCAM-Fehlers 


| Erzwungene Beendigung der DCAM-Anwendung 
wegen der Angabe eines ungültigen Contingency/ 
Ereigniskennzeichens durch den Primärprozeß 


Erzwungene Beendigung der DCAM-Anwendung 
wegen der Angabe eines ungültigen Contingency-/ 
Ereignis-Kennzeichens d.d. Sekundärprozeß 


| Erzwungene Beendigung der DCAM-Anwendung 
durch die Beendigung des Primärprozesses 


Beendigung der DCAM-Anwendung durch eine 
| Anforderung des Primärprozesses 
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| Beendigung der DCAM-Anwendung durch eine 
Anforderung eines Sekundärprozesses 


Für diesen Prozeß wurden zu viele Aufrufe 
gleichen Typs gleichzeitig gegeben 
(max, 8 erlaubt). 


Die DCAM-Anwendung ist nicht aktiv 


ungültiges Kennwort (USEPW) 


Der Prozeß hat zu viele Anwendungen eröffnet 


Zu viele nicht vordefinierte Anwendungen 
für einen Prozeß u 
ungültige Kennwort bei existierenden RDF- — 
Kennwort - 
Die Anwendung ist durch ein anderes Subsystem 
eröffnet x 
Zu viele nicht vordefinierte Anwendungen x 
Zu viele Verbindungen für die nicht E 
vordefinierte Anwendung — 
| Die DCAM-Version entspricht nicht der durch den x 


Primärprozeß angegebenen. 


š + 
Ж 


Ее ET АЙРЫ Sesi TE EL 15 05-2 


сс ы с. т сте CP ET олт, жз Ai аға жтт ик NM 
BE ш ы WENDE ае L га ти 2 MIDI EB 


FRE alt U ZI DE BI EU FR ари III PB Er К II 
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| Rücknelde-Feld ` 


| Rücknelde-Feld | Bedeutung 


Der Partner ist mit der DCAM-Anwendung nicht 
verbunden (ungültiges CID). 


Der Partner ist bereits mit der DCAM-Anwendung 
verbunden. 

Hinweis: CID wird von DCAM im RPB und CCB wie 
bei einem Returncode 00 00 ergänzt. 


Von diesem Partner wurde bereits eine 
Aufforderung in die Warteschlange 
eingereiht (kein ACQIRE möglich). 


Der DIP-Steuerblock ist nicht aktiv 
(ungültiges DID). 


Ungültiges LID 
Die Verbindung ist durch eine Anforderung des 


Benutzers abgebaut worden, oder durch einen 
YCLSCON. 


Es ist eine erzwungene Verbindungsunterbrechung 
zum, Partner aufgetreten oder der Partner hat 
die Verbindung abgebrochen. 


BZW. Der Partner befindet sich im CS-Zustand und 
der Übergang in den CA-Zustand ist noch nicht 
abgeschlossen. 


Der Partner befindet sich im CS-Zustand mit 
noch nicht beendeten YRECEIVE-Befehlen. Der 
angeforderte Übergang in den CA-Zustand ist 
nicht zulässig. 


noch nicht beendeten YRECEIVE-Befehlen. Der 
angeforderte Übergang in den CA-Zustand ist 
nicht zulässig. 


Der Partner befindet sich im CS-Zustand für 

einen anderen Prozeß. 

Der Partner befindet sich im CA-Zustand. 

YRECEIVE (mit OPTCD=SPEC) ist nicht zulässig 

Die Nachricht ist zu lang (länger als —Ç 
MAXLN). _ 
Die Lage des Verteilcodes überschreitet die 
maximale Länge der Nachricht. 


Die fortlaufende Nummer ist bereits benutzt; 
der Quitterungsvorgang ist noch nicht 
abgeschlossen. 
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Makroaufruf 


A2-7 


Makroaufruf Ж 


OPTCD=EXPRESS nicht möglich, wenn 
EDIT=SYSTEM | — 

1? Diese Meldungen werden gegeben, wenn eine Aufforderung zum Verbindungsaufbau an die Systemanwen- 

dung ”"$CONSOLE” von dieser zurückgewiesen wird. 


о ог" + m @ ل‎ 


Systemzeitablauf für die Verbindungsanforderung 


Der Partner ist nicht erreichbar; falls DCAM- — 
Anwendung dann ist diese nicht eröffnet. S 
| Der Partner bearbeitet keine Aufforderungen u 


zum Verbindungsaufbau (Die DCAM-Anwendung 
befindet sich im STOP-Zustand). 


Der Partner hat die Verbindung ohne Angabe eines | 
Grundes zurückgewiesen 


| ungültige DEPROT/EDIT Kombination 


Der Partner will keine Auffarderungen zum 
Verbindungsaufbau annehmen (Die DCAM- 
Anwendung hat die Eigenschaften ATTR=NLOGON). 


ungültiges Kennwort (106РИ) —< 


Die Verbindungsaufforderung ist vom Partner S 
zurückgewiesen worden (z.B. REJLOG-Makroaufruf) | 


Die Partnercharakteristika wurden vom Partner 
nicht angenommen 


Fehler im Stationsdienstprotokoll u 


Der Partner bearbeitet keine Aufforderungen zum 
Verbindungsaufbau; eine Aufforderung zum Verbin- 
dungsaufbau durch den Partner folgt 


Fehler in der Aktivierung der VTSU-Unterstützung | 
des Partners : 
Der Partner ist einer anderen DCAM- u 
Anwendung zugehörig. 


Der DIP-Steuerblock adressiert keinen DCG- 
Steuerblock 


Die Verbindung wurde unmittelbar nach dem 
Verbindungsaufbau vom Partner oder vom System 


abgebaut. 


Е2:1::51:3:::::2:2:3Н | 
EY 
EZ” 
Es 


Die vorgeschlagene Transport-Serviceklasse wurde | 
| vom Partner nicht angenommen u 


Die vorgeschlagene Datennetz-Priorität wurde —< 
| vom Partner nicht angenommen 

Fehler bei der Verarbeitung — 

(z.B. Stórung bei X.25) — 


Die Aufforderung zum Verbindungsaufbau wurde von | 
der Verwaltung zurückgewiesen. 

In diesem Fall mit dem Systemverwalter Verbin- 
dung aufnehmen. 


% 


VEREINE ТЫ шын ғыт жыш ПЫ Засаг NOSE Сы КС Ее қои Болар че ола КОБО За Ж ER ОБР E арс 9 
BEE аңға GA FT EM е Хе ЭЭ Жез u ИЕНІ ШЕНӘ a еа Жі кс қы а ЕЕ oak 
ына» МЫ ЗЫ ШИШЕ КӨЛ “ас “2% a Ei ORTE BE хош ET Баты БИШ: Базы Бал жы жағы” ЫНА пове со 
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Bedeutung Makroaufruf 


Rückmelde-Feld 


: хх E 


WE жара LER NETT SET WEE E МЫС ЕСИ аиати НЭРТ ART A 


МСИ 


EOC OE € 
о ог + m о 


8 
тота 


о ра раа асса 


Der Makroaufruf ist wegen des aktuellen 
Zustandes des Kommunikationszugriff-Systems 
(DCM) zurückgewiesen worden. 


"| DCAM: Mangel an Speicherplatz 
"| Gründe (nur für Diagnosezwecke) 
BCAM: Ein/Ausgabe später versuchen 


BCAM: Mangel an Speicherplatz 


BCAM: Warten auf das Go-Signal 


DCAM: Kein Steuerblock verfügbar 

DCAM: Kein ID-Eintrag verfügbar 

DCAM: Kein Speicherplatz verfügbar ($REOM) 
DCAM: Überlastung im System des Partners 


Warnung: Beendigung des DCM 


Beendigung des DCM 


DCM ist nicht aktiv 


DCM-Fehler 


DCAM vorübergehend gesperrt 


Unzulässiger Gebrauch des Makroaufrufs 


Der Makroaufruf kann nicht von einem Sekundär- 
. | prozeß ausgegeben werden. 


14 | Der Makroaufruf ist nicht anwendbar im Zusam- 
menhang mit DCAM-Anwendungen, die die Eigen- 
schaft ATTR=NSHARE oder 

ATTR=(SHARE,NDISCO) haben. 

14 Der Makroaufruf ist nicht anwendbar im Zusam- 
menhang mit DCAM-Anwendungen, die die 
Eigenschaft ATTR=NLOGON haben. 

14 Gleichwertige Makroaufrufe stehen bereits zur 
Bearbeitung an 

(OPTCD=(ACQUIRE,ASY) oder 
OPTCD=(ACCEPT,SPEC,ASY) 


Die DCAM-Anwendung ist nicht berechtigt, diesen 
Makro-Aufruf zu geben. —< 


Ein synchroner Aufruf ist bereits in der 
Warteschlange für diesen Prozeß eingetragen 
ОРТСП-(5ҮМ,0). 
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А2-9 


і Қосан | 
18 u 
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| Operanden zurückgewiesen. 


М | Der Makroaufruf wurde wegen falscher 


ungültige ACB-Steuerblockadresse 


18 ungültige CCB-Steuerblockadresse 


18 ungültige DCG-Steuerblockadresse 


= т 


ungültige DIP-Steuerblockadresse 
| ungültige ENB-Steuerblockadresse 


ungültige APPNAME-Adresse 


ungültige DISNAME-Adresse 


ungültige PTNNAME-Adresse 


ungültige Adresse des Contingency- 
| Kennzeichens 


ungültige Adresse des Ereigniskennzeichens 


ungültige AREA-Adresse 


ungültige AAREA-Adresse 


ungültiger Name der DCAM-Anwendung 


ungültiger Verteilungsname 


— 


ungültiger Partnername 


ungültiger Prozessorname 


| | Der CCB-Steuerblock ist für einen asynchron — 
| ablaufenden Makroaufruf belegt (aktiver ССВ) . 


Die fortlaufende Nummer überschreitet die 
| obere Grenze. 


AAREALN ist kleiner als 8 Bytes/AREALN=0. 


| ungültige Unterfunktion 


|| ungültige PRONAME-Adresse 


negative AREALN 


nicht behebbarer Fehler, die Nachrichten- 
aufbereitung betreffend: 
EDIT-Parameter-Fehler 

unzulässiger Geräteheader 

Länge der Nachricht ist 0 

VTSU ist nicht verfügbar 


ungültige Verteilcodelänge (CODELN) 
reserviert 


reserviert 


BE TCO E LCE Тл E чр ао ги. 
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Der Makroaufruf wurde zurückgewiesen wegen 
falscher Adressierung oder Registerangabe. 


x Ë | ungültige ACB-Steuerblockadresse; х 


ungültige RPB-Steuerblockadresse 

oder 

der RPB-Steuerblock ist für einen asynchron 
ablaufenden Befehl (aktiver RPB) belegt. 


Inhalte werden von einer speziellen Exit-Routine 
| definiert; Rückfragen ggfs. an den Systemver- 
walter richten 
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A.3 Registerbelegung 


1. Registerbelegung bei Beendigung eines Aufrufs an DCAM: 


Für die Inhalte von Register 15 können symbolische Adressen generiert werden (Makroaufruf 


YDDFDB, Anhang A.7). 
Register 2-14 [Register 15 


Rückgabe von einem auf 
einen ACB-Steuerblock verändert 
bezogenen Makroaufruf 


Rückgabe von einem auf 
einen RPB-Steuerblock verändert FDBK-Feld 
bezogenen Makroaufruf 
Rückgabe vom YGENCB- Länge vom |Adresse vom Rückmeldung 
Makroaufruf Steuerblock |Steuerblock 
Rückgabe vom YMODCB- verändert Rückmeldung 
ç Makroaufruf 
Rückgabe vom YSHOWCB- erforder- | verändert 
Makroaufruf liche 
Speicher- 
länge 


Rückgabe vom YTESTCB- Test- verändert Rückmeldung 
Makroaufruf resultat 


*) bedeutet unverändert 


FDBK-Feld 
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2. Registerbelegung bei Anstoß einer Contingency wegen 
einer asynchronen DCAM-Meldung 
Reg. |Inhalt 


1 Contingency-Information, die im Makroaufruf ENACO 
mit dem Parameter COMAD festgelegt wurde. 


2 Grund für den Anstoß der Contingency-Routine in 
2 Bytes: 


ES 
ІІ 


Ereignis-Schalter (rechtsbündig) 
Informations-Indikator (linksbündig) 
Die Angaben in folgender Tabelle sind 
sedezimal: 


II ES 


00 00 Keine Contingency-Information (COMAD) 
08 00 vorhanden. 


04 00 Eine Contingency-Information (COMAD) ist 
OC 00 vorhanden. 


LOGON |Loscon |PROCON COMEND [EXPR | TACK [SECOND 
po fpo ш ш Jm jn 
4 Inhalt Inhalt 
siehe siehe 
Seite A3-3 
5 Inhalt Inhalt Vertei- 
von von lungs- 
USERFLD USERFLD |name 
im CCB- im CCB- 
Steuer- Steuer- 
block block 
6 Quittung 
0 bed. 
EXPRESS- |positiv 
Nach- 4 bed. 
richt negativ 
7 Laufende 
schlossen 
ist 
8 
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Für die folgenden Inhalte können symbolische Adressen generiert werden (Makroaufruf 
© YDDFDB, Anhang A.7). 


Inhalt (rechtsbündig) von Register 6 bei LOSCON: 


Х'00' |дег Verbindungsabbruch wurde vom Benutzer 
angefordert. 


Х'04' |Ungültige Kombination DEPROT mit EDIT 


Х'08' |Verarbeitungsfehler z.B. bei einer Störung 
an X.25 


A DC |Der Partner ist nicht mehr verfügbar 
bzw. die Datenstation ist ausgefallen. 


Х'10' |Verbindungsabbruch durch externen Eingriff 
(Systemoperator). | 


Х'14' |Die Verbindung wurde im Netz unterbrochen. 
Es ist eine erneute Aufforderung zum Verbindungs- 
aufbau zu erwarten. 


einen Zusammenbruch im Datenübertragungsnetz 
zurückzuführen. 


© Х'18' |Der Verbindungsabbruch ist auf eine Störung oder 
Х'1С' |reserviert 
Х'20' |Warnung vor dem bevorstehenden Verbindungsabbruch. 


Х'24' |reserviert 


X'28' |0іе Verbindung des Partners wurde nach Aufforderung- 
durch die Systemverwaltung aufgelöst 


X'2C’ |Fehler im Verbindungselement des Stations- 
dienstes 


X'30’ |геѕегуіег+ 

X'34' |Fehler im Stationsdienstprotokoll 
X'38' |Fehler im Transportsystem 

X'3C’ |reserviert 


Х'40' |Fehler in der Verbindungsnachricht des 
6. Stationsdienstes für den Benutzer 


Х'44' |reserviert 

Х'48' |reserviert 

Х'4С' |reserviert 

Х'50' |Die vorgeschlagene Klasse des Transportservice 
wurde vom Kommunikationspartner nicht 
akzeptiert. 

Х'Б4' |0іе vorgeschlagene Priorität im Datenüber- 
tragungsnetz wurde vom Partner nicht akzep- 
tiert. 

X'58' |Die Verbindung wurde wegen DCM-Mangel an 
Speicherplatz abgebaut (zu viele negative 
Transportquittungen, die nicht abgeholt 


wurden). 


ABC |Піе VTSU des Partners ist nicht aktiv. 
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Inhalt | (rechtsbündig) von Register 4 bei COMEND: 


Х'00' |Warnung - vor der bevorstehenden Beendigung 
des Kommunikationszugriffssystems 


Х'04' |Beendigung des Kommunikationszugriffssystems 


Х'08' |Магпипд - vor der bevorstehenden, erzwungenden 
Beendigung der DCAM-Anwendung 


OCT |Erzwungende Beendigung der DCAM-Anwendung 
Inhalt | (rechtsbündig) von Register 4 bei SECOND: 
Х'00' |Eröffnen der Anwendung im Sekundärprozeß 
X'04' |Schließen der Anwendung im Sekundärprozeß 
Х'08' Nachrichten für Verteilungsnamen ohne Sekundärprozeß 


Alle weiteren Register enthalten keine definierten Werte und sind daher vom Benutzer selbst 
zu versorgen (einschl. der Basisregister). 
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А.4 Partnercharakteristika 


Aufteilung des Feldes, das von DCAM beim Makroaufruf YINQUIRE (OPTCD=PTNCHAR) 
ausgefüllt wird: 
Länge in Bytes Bedeutung 


1 Art des Partners 1) 
(Anwendung oder Datenstation) 


1 Gerätetyp 


2 Zeilenlänge physikalische 
2 Anzahl der Zeilen Geräte- 
2 Maximaler Gerätepuffer eigenschaften 
© 2 reserviert 
2 Zeilenlänge Eigenschaften 
2 Anzahl der Zeilen der logischen | nur nur 
2 Maximaler Gerätepuffer Datenstation für für 
2 reserviert von Typ LINE EDIT= PTNTYPE 
SYSTEM | =TERM 


1 Fähigkeit der Nachrichtenaufbereitung 

7 reserviert 

2 eingestellte Nachrichtenaufbereitung 
für Eingabe 

2 eingestellte Nachrichtenaufbereitung 
für Ausgabe 


12 reserviert 


1) Die ersten 4 Bytes werden bei YOPNCON in den CCB eingetragen (PTNCHA1). Das erste 
Feld kann mit dem Makroaufruf YTESTCB ausgewertet werden. Der Name des Feldes 
lautet in diesem Fall РТМТҮРЕ” und die Einträge lauten ‘APPL’ für Anwendung und 'TERM' 
с für Datenstation. 


2) nicht unterstützt (Wert ist X'00') 


Um die Felder auszuwerten steht der Makroaufruf DCSTA zur Verfügung (siehe folgende 
Seiten). 
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Der Makroaufruf DCSTA generiert die Namen der Felder, welche die Partnercharakteristika 
enthalten. Der Eintrag in Felder von insgesamt 48 Bytes Länge erfolgt von DCAM mit dem 
Makroaufruf YINQUIRE und dem Operanden OPTCD = PTNCHAR. 


Hinweis: 


DCAM liefert die Partnercharakteristika nach wie vor in einem Feld von 48 Bytes Länge 
(adressiert durch den Operanden AAREA im RPB). Der durch den Makro DCSTA gelieferte 
Bereich (DSECT oder CSECT) verlängert sich jedoch von 48 auf 64 Bytes. Die Bytes 49 - 64 sind 
jedoch für DCAM irrelevant. 


In folgender Form ist der Makroaufruf für DCAM zu verwenden: 


Name Operanden 
[symbol] | DCSTA С 
1-1) 
D 
[ prefix] 
‚TYPE=ALL 
С Es wird ein Abschnitt (CSECT) generiert. 
D Es wird ein Pseudoabschnitt (DSECT) generiert. 
prefix Gibt eine Zeichenfolge von max. 3 Zeichen an, die dem Namen der Felder 
vorangestellt wird. Fehlt die Angabe, wird die Zeichenfolge "GTA eingetra- 
gen. 
TYPE=ALL Es werden alle Felder generiert. Diese Angabe ist Pflicht, da DCAM in die 


ersten 48 oder 60 Bytes des Bereichs Eintragungen macht. 


Die folgenden Seiten zeigen die Auflösung dieses Aufrufs mit den symbolischen Namen der 
einzelnen Felder und deren Inhalte. 
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STAALL 


STASTALL 
STAMNALL 


* 
* 
* 
STAALTCH 
* 
ж 
ж 


STASTTCH 
STAMNTCH 
* 

STAPTTYP 
STADVTYP 
STATCHR2 
STATCHR3 


STACTRLU 
STACHCAD 


* 
* 
* 


STADCAMP 
STADCAMT 


ж 


ж 
ж 
ж 


STAD8103 
STAD8150 
STAD8153 
STADHOST 
STAD8151 
STAD8152 
STAD8110 
STAD6154 
STAD6164 
STAD6180 
STAD8161 
STAD8121 
STADPT8O 
STAD1000 
STADT100 
STAD100E 
STAD8122 
STAD8162 
STAD8160 
STAD8124 
STAD8167 
STADAP 

STAD9750 
STAD9003 
STAD9002 
STAD3974 
STAD9751 
STAD9752 
STAD9753 
STAD9001 
STAD9731 


DCSTA D,TYPE=ALL 


IDLKG 


DSECT 


DS 
DS 


DS 


EQU 
EQU 


МЕН-804, ID=ALL, SECT=D , Р-5ТА, ALIGN=D 804 
*,VERSION 804 
DEFINE TOTAL STATUS AREA 


0С164 
0С148 


TOTAL STATUS AREA 
MINIMUM TOTAL STATUS AREA 


DEFINE TOTAL STATUS AREA TERMINAL CHARACTERISTICS 
OD TERMINAL CHARACTERISTICS AREA 


DEFINE TERMINAL CHARACTERISTICS FIELDS 


OD TERMINAL CHARACTERISTICS AREA 
OD MINIMUM TERMINAL CHARICS. AREA 
А11(0) PARTNERTYPE 

AL1 (0) DEVICE TYPE 

AL1 (0) TERMINAL CHARACTERISTICS BYTE 2 
AL1 (0) TERMINAL CHARACTERISTICS BYTE 3 
2AL1 (0) RESERVED FOR FUTURE DEVELOPM701 
AL1 (0) CONTROL UNIT FOR PRINTER 701 
AL1 (0) CENTRAL HARDCOPY ADDRESS 


DEFINE PARTNER TYPES (PTTYP) 


X00 PARTNER IS A PROGRAM 
X01 PARTNER IS A TERMINAL 


DCDEVCH STA 
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DEFINE DEVICE TYPES (DVTYP) 


Х'02' TELETYPE 8103 

X'04' VIDEO TERMINAL 8150 

Х'О5' *AS 8150: VIDEO TERMINAL 8153 

X'08' INTELLIGENT PARTNER 

Х'15' VIDEO TERMINAL 8151 

Х'16' VIDEO TERMINAL 8152 

X17 SS-8110 

Х'18' VIDEO 8161 54 CHAR PER LINE 

Х:19: VIDEO 8161 64 CHAR PER LINE 

Х'1А' VIDEO 8161 80 CHAR PER LINE 

Х'1А' VIDEO 8161 

X'1C' PRINTER STATION 8121 701 
A ID *AS 8103х TELETYPE PT80 

Х'1Е' xAS 8103х TELETYPE 71000 

Х'23' «А5 8103х TELETYPE 7100 

Х'26' «А5 8103* Ғ5100-Е 701 
Х'2В' PRINTER STATION 8122 701 
Х'2С' VIDEO 8162 

X'2D' VIDEO 8160 

x ZE PRINTER STATION 8124 701 
Х'2Е' хАЅ 8160% VIDEO 8167 

Х'30' »AS НО5Тх АР-5ТАТТОМ 

Х'35' VIDEO 9750 OR 9749 803 
X'36' PRINTER STATION 9003 701 
Х'ЗВ' PRINTER STATION 9002 701 
X'3D' VIDEO TERMINAL 3974 803 
X” AE xAS 9750% DSS 9751 

Х'40' «А5 9750х DSS 9752 701 
A Ai «А5 9750х 055 9753 701 
Х'42' PRINTER 9001 801 
A A3 *AS 3974х GRAFIC STATION 9731 803 


A4-3 
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5ТАП9004 
5ТАП9754 
STADBTXF 
STADBTXE 
STADBTXA 


* 
* 
* 


5ТАТС2ЕХ 
5ТАТС21С 
STATC2DF 


* 
ж 
ж 


5ТАТСЗН1 
5ТАТСЗН2 
5ТАТСЗНС 
5ТАТСЗІС 
STATC3FD 
STATC3AP 
STATC3GF 
STATC3DZ 
STATC3DF 


* 
* 
ж 
ж 
STAALPV 
* 


* 
ж 


STASTPV 
STAMNPV 
ж 
STALLEN 
STANOLIN 
STAMAXDB 


* 
* 
* 
STAALLV 
* 
* 
* 


STASTLV 
STAMNLV 
* 
STALLLEN 
STALNOLN 
STALMAXB 


* 
* 
* 
STAALVDT 
* 
* 
ж 


STASTVDT 
STAMNVDT 


* 


STAVDT 


* 
* 


DS 


DS 
DS 


DC 
DC 
DC: 
DC 


DS 


DS 
DS 


DC 
DC 
DC 
DC 


DS 


DS 
DS 


DC 
DC 


A Ab PRINTER 9004 701 
A AL *AS 8160* VIDEO 9754 803 
A bb *AS Н05Тт% БВТХ-5ТАТ10М T-3000 (FELDVERS.) 803 
A 56 xAS HOST« ВТХ-ЕПІТІЕН-5ТАТІОМ (DIENST) 803 
Х'57' *AS НО5Т* БВТХ-АВҒНАСЕ-5ТАТІОМ (DIENST) 803 
DEFINE TERMINAL CHARACTERISTICS BYTE 2 (TCHR2) BITS 

8 SECONDARY CHARACTER SET 

32 LOWER CASE 

128 BYTE 2 DEFINED 

DEFINE TERMINAL CHARACTERISTICS BYTE 3 (TCHR3) BITS 

1 HARDCOPY BIT 1 (LOCAL) 

2 HARDCOPY BIT 2 (CENTRAL) 

3 HARDCOPY BITS 

4 IDENTITY CARD READER 

8 FLOPPY DISK 

16 APL CAPABILITY 

32 GRAPHICS 

64 DEZENTRAL FORMATING 701 
128 BYTE 3.DEFINED 

х , DCDEVCH 803 840417 53113038 


DEFINE TOTAL STATUS AREA PHYSICAL TERMINAL ATTRIBUTES 
OD PHYSICAL TERMINAL АТТА. AREA 


DEFINE PHYSICAL TERMINAL ATTRIBUTES FIELDS 


OD PHYSICAL TERMINAL ATTR. AREA 

OD MINIMUM PHYS. TERM. ATTR. AREA 
RE PHYSICAL LINE LENGTH 

H’O’ PHYSICAL NUMBER OF LINES 

H’O’ MAX. PHYSICAL DEVICE BUFFER 
2А11(0) RESERVED FOR FUTURE DEVELOPMENT 


DEFINE TOTAL STATUS AREA VIRTUAL TERMINAL ATTRIBUTES 
OD VIRTUAL TERMINAL ATTR. AREA 


DEFINE VIRTUAL TERMINAL ATTRIBUTES FIELDS 


OD VIRTUAL TERMINAL ATTR. AREA 

OD MINIMUM VIRTUAL TERM ATTR AREA 
H'O’ VIRTUAL LINE LENGTH 

H'O’ VIRTUAL NUMBER OF LINES 

H’O’ MAXIMUM VIRTUAL DEVICE BUFFER 
2А11(0) RESERVED FOR FUTURE DEVELOPMENT 


DEFINE TOTAL STATUS AREA VIRTUAL DEVICE TYPE AREA 
OD VIRTUAL DEVICE TYPE AREA 


DEFINE VIRTUAL DEVICE TYPE FIELDS 


OD VIRTUAL DEVICE TYPE AREA 
OD MINIMUM VIRTUAL DEV TYPE AREA 
AL1 (0) VIRTUAL DEVICE TYPE 


7AL1 (0) RESERVED FOR FUTURE DEVELOPMENT 


VIRTUAL DEVICE TYPE (STAVDT) BITS 
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* 


STALINCP 
STAFORCP 
STACMPCP 
STAFYSCP 
STAEOM 
STANOINP 
* 

ж 

ж 
STAALEDT 
ж 

ж 

ж 


STASTEDT 
STAMNEDT 
ж 
STAEDIT 
STASEWR1 
STASEWR2 
STASERD1 
STASERD2 


* 
* 
* 


STAWR1CD 
STAWR1LE 
STAWRIRE 
STAWR1HO 
STAWR1PT 
STAWRIHC 
* 

STAWR1M1 
STAWR1M2 
STAWR1MM 
STAWRILI 
STAWR1FO 
STAWR1CO 
STAWRIFY 


ж 
ж 
ж 


STAWR2HD 
STAWR2NO 
STAWR2EX 
STAWR2IM 
STAWR2RB 
STAWR2PN 
ЅТАМА2ТР 
STAWR2BL 
5ТАМІН2ЕТ 
ж 

ж 

ж 


STARDICD 
STARDILE 
STARD1BS 
STARDIPT 
STARDILC 
STARD1HD 
* 

STARD1M1 
STARD1M2 
STARD1MM 
STARD1CO 
STARDILI 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


DS 
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LINE MODE CAPABILITY 

FORM MODE CAPABILITY 

COMP MODE CAPABILITY 

PHYS MODE CAPABILITY 
EVANESCENT OUTPUT MESSAGES 
OUTPUT ONLY DEVICE 


DEFINE TOTAL STATUS AREA STATIC EDIT OPTIONS AREA 


oD 


STATIC EDIT OPTIONS AREA 


DEFINE STATIC EDIT OPTIONS FIELDS 


oD 
oD 


ОА 

А11(0) 
AL1 (0) 
AL1 (0) 
AL1 (0) 
4AL1 (0) 


STATIC EDIT OPTIONS AREA 
MINIMUM STATIC EDIT OPTS. AREA 


STATIC EDIT OPTIONS 

STATIC WRITE EDIT OPTION BYTE 1 
STATIC WRITE EDIT OPTION BYTE 2 
STATIC READ EDIT OPTION BYTE 1 
STATIC READ EDIT OPTION BYTE 2 
RESERVED FOR FUTURE DEVELOPMENT 


OUTPUT EDIT OPTION BYTE 1 (STASEWR1) BITS 


CODE TRANSLATION 
LINE END TREATMENT 
RESET CONTROL 
HOMOGENEOUS OUTPUT 
PAPER TAPE CONTROL 
HARDCOPY 


MODE BIT 1 

MODE BIT 2 

MODE MASK 

LINE MODE 
FORMAT MODE 
COMPATIBLE- MODE 
PHYSICAL MODE 


OUTPUT EDIT OPTION BYTE 2 (STASEWR2) BITS 


HEADER PRESENT 

NO LOGICAL CHARS INTERPRET 801 
EXTENDED LINE MODE 701 
INFORMATIVE MESSAGE 

RETURN INFORMATION REQUIRED 
POSITIONING NOT REQUIRED 
TRANSPARENT CODE 

BEL INDICATED 

USE ETB 


(STASERD1) BITS 


CODE TRANSLATION 
LINE END TREATMENT 
BACKSPACE CONTROL 
PAPER TAPE CONTROL 
LOWER CASE CONTROL 
HEADER REQUIRED 


MODE BIT 1 
MODE BIT 2 
MODE MASK 
COMPATIBLE MODE 
LINE MODE 
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STARD1FO 
STARDIFY 


* 
* 
* 


STARD2FC 
STARD2CF 
STARD2IC 
STARD2EX 


* 

* 

* 

* 
STAALOFL 
* 

* 

* 


STASTOFL 
STAMNOFL 


* 


STAOFLOW 


ж 
ж 
ж 


5ТАОҒСТМ 
5ТАОҒАСК 
5ТАОҒСАК 
5ТАОҒСМР 
STAOFCTL 
STAOFPGM 


* 
* 
ж 
STAALSTN 
ж 
ж 
ж 


STASTSTN 
STAMNSTN 
ж 
STASTNAM 
* 
* 
* 
* 


STAALPRN 
STALPDT 


ж 
ж 
ж 


STASTPRN 
STAMNPRN 


ж 


5ТАРНМАМ 


ж 


EQU 
EQU 


EQU 
EQU 
EQU 
EQU 


DS 


DS 
DS 


DC 
DC 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


DS 


DS 
DS 


DC 


DS 
EQU 


DS 
DS 


DC 


END 


64 FORMAT MODE 
96 PHYSICAL MODE 


INPUT EDIT OPTIONS BYTE 2 (STASERD2) BITS 


1 FUNCTION CODE REQUIRED 

4 CONFIDENTIAL INPUT EXPECTED 

8 INPUT FROM CARD READER 

32 EXTENDED LINE MODE 701 


DEFINE TOTAL STATUS AREA OVERFLOW CONTROL BYTE AREA 
OD OVERFLOW CONTROL BYTE AREA 


DEFINE OVERFLOW CONTROL BYTE AREA FIELDS 


OD OVERFLOW CONTROL BYTE AREA 

OD MINIMUM OVERFLOW CTL. BYTE AREA 
AL1 (0) OVERFLOW CONTROL BYTE 

7AL1 (0) RESERVED FOR FUTURE DEVELOPMENT 


OVERFLOW CONTROL BYTE (STAOFLOW) BITS 


OVERFLOW CONTROL BY TIME 
OVERFLOW CONTROL BY ACKNOWL. 
OVERFLOW CONTROL BY ACKNOWL. 
AUTOMATIC NEW PAGE 801 
OVERFLOW CONTROL TEST 

2 OVERFLOW CONTROL BY USER PGM 


LA I L N N ~ 


DEFINE TOTAL STATUS AREA STATION NAME AREA 
0D STATION NAME AREA 


DEFINE STATION NAME AREA FIELD 


0D STATION NAME AREA 
0D MINIMUM STATION NAME AREA 
CL8' ` STATION МАМЕ 


DEFINE TOTAL STATUS AREA PROCESSOR NAME AREA 


OD PROCESSOR NAME AREA 
8 


DEFINE PROCESSOR NAME AREA FIELDS 


OD PROCESSOR NAME AREA 
OD MINIMUM PROCESSOR NAME AREA 
CL8' PROCESSOR NAME 


*,DCSTA 804 840604 53531014 
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Mnemotechnische Werte der Makroaufrufe 


Mnemotechnische Werte helfen dem Anwender, sich die Form eines bestimmten Operanden 
zu merken, die er annehmen kann. Es sind 8 mnemotechnische Werte, die in dieser Beschrei- 
bung verwendet werden. Ihnen können 8 unterschiedliche Operandenformen zugeordnet 
werden (siehe Tabelle) 


Mnemotechn. Operandenformen 
Wert 


Relativ |Register- 

zusammen- | бегеісһ- 
gesetzter 
Ausdruck 


Relative zusammengesetzte Ausdrücke 


Ein relativer zusammengesetzter Ausdruck wird als solcher definiert, wenn sich sein Wert um 
n ändern würde, falls man das Programm um n Bytes von seinem ursprünglichen Speicher- 
platz verschiebt. Alle relativen zusammengesetzten Ausdrücke müssen einen positiven Wert 
haben. Ein relativer zusammengesetzter Ausdruck kann auch aus einer arithmetischen 
Kombination von Ausdrücken bestehen. Diese Kombination kann allein aus relativen und 
absoluten Ausdrücken bestehen. Dabei bestehen die folgenden Bedingungen: 


1. Die Anzahl der relativen Ausdrücke muß ungerade sein. 


2. Alle relativen Ausdrücke müssen paarweise auftreten, wobei 1 relativer Ausdruck zusätz- 
lich vorhanden sein muß. Die Paarbildung wird unter "absolute zusammengesetzte Aus- 
drücke’ beschrieben. 


3. Der unpaarige Ausdruck darf kein Minuszeichen haben. 


4. Ein relativer Ausdruck darf nicht als Operand in einer Multiplikation oder Division auftre- 
ten. 


Einem relativ zusammengesetzten Ausdruck wird vom Assembler ein einziger Wert zugeord- 
net. 


In den folgenden Beispielen von relativ zusammengesetzten Ausdrücken sind SAM, JOE und 
FRANK in dem gleichen Programmabschnitt und sind relative Ausdrücke, PT ist ein absoluter 
Ausdruck. 


SAM 
SAM-JOE+FRANK 
JOE-PT*5 
SAM+3 
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А5 - 2 


Hinweis: 


SAM-JOE ergibt keinen relativen Ausdruck, da die Differenz von zwei relativen Adressen 
einen konstanten Wert darstellt. 


Registerbezeichnungen 


Registerbezeichnungen werden als absolute Ausdrücke geschrieben, die in Klammern einge- 
schlossen werden. Die absoluten Ausdrücke müssen Werte zwischen 2 und 12 annehmen. Sie 
sind die zugehörigen Mehrzweckregister. 


Im folgenden Beispiel für Registerbezeichnungen sind SAM und JOE wiederauffindbare 
Ausdrücke und PAL ist ein absoluter Ausdruck. 


(5) zeigt Register 5 an 
(SAM-JOE) 

(PAL) 

(PAL+3) 


Symbol 


Der Operand wird als Folge von bis zu acht Zeichen geschrieben, wobei das erste alphabetisch 
sein muß. Kommas und Leerzeichen sind nicht erlaubt. Symbole, die mit dem '$'-2еісһеп 
beginnen, sind nicht erlaubt. Die Symbole, die mit diesen Zeichen beginnen, sind für die 
Verwendung im System reserviert. Beispiele für Symbole sind: 


LEE 

. MARGIE3 
BIL8SAM 
DEBDEB 


Dezimaler Integer 


Die Operanden werden als Dezimalzahlen mit bis zu acht Ziffern geschrieben, wie 5,31,127, 
usw. 


Absolute zusammengesetzte Ausdrücke 


Ein absoluter zusammengesetzter Ausdruck kann ein absoluter Ausdruck oder irgendeine 
arithmetische Kombination von absoluten Ausdrücken sein. Ein absoluter Ausdruck kann ein 
absolutes Symbol oder irgendeiner der sich selbst definierenden Ausdrücke sein. Alle 
arithmetischen Operationen sind zwischen absoluten Ausdrücken erlaubt. 


Ein absoluter zusammengesetzter Ausdruck kann nur relative Ausdrücke oder solche in 
Kombination mit absoluten Ausdrücken unter folgenden Bedingungen enthalten: 


1. In dem zusammengesetzten Ausdruck muß eine gerade Anzahl relativer Ausdrücke 
vorhanden sein. 


2. Die relativen Ausdrücke müssen paarweise auftreten. Jedes Paar von Ausdrücken muß 
dasselbe relative Attribut haben, das heißt, sie erscheinen in demselben Programmab- 
schnitt des Assembler-Codes. Jedes Paar muß aus Ausdrücken mit entgegengesetzten 
Vorzeichen bestehen. Die Ausdrückspaare müssen nicht zusammenhängend sein, wie z.B. 
RT+AT=RT, wobei RT relativ und AT absolut ist. 


3. Ein relativer Ausdruck darf nicht in einer Multiplikations- oder Divisionsoperation auftau- 
chen. 


Das Paaren relativer Ausdrücke (mit entgegengesetzten Vorzeichen und demselben relativen 
Attribut) löscht den Effekt der Relativierung. Der von den gepaarten Ausdrücken dargestellte 
Wert bleibt konstant, auch bei Programmverschiebung. 


Zum Beispiel ist A in dem absoluten zusammengesetzten Ausdruck A-Y+X ein absoluter 
Ausdruck, während X und Y relative Ausdrücke mit demselben relativen Attribut sind. Ist 
A=50, Y=25 und X=10, würde der Wert des zusammengesetzten Ausdrucks 35 sein. Sind X 
und Y um den Faktor 100 verschoben, wären ihre Werte 125 und 110. Der zusammengesetzte 
Ausdruck wird jedoch weiterhin gewertet als 35 (50-125 + 110 = 35). Ein absoluter zusammen- 
gesetzter Ausdruck wird auf einen einzelnen absoluten Wert reduziert. 
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In den folgenden Beispielen von absoluten zusammengesetzten Ausdrücken sind JOE und 
SAM relativ und in demselben Programmabschnitt definiert, während BERNY und DAVE 
absolut sind: 


BERNY+DAVE-83 

JOE-SAM 

DAVE*4+BERNY 
Code 


Ein Code wird wie ein Makroaufruf geschrieben, wie z.B.: 


FTBAL 


ziel-code gibt die gewünschte Aktion an 


Operand 


[symbol ] ziel-code 


BB Bodenberührung 
FT Fußballtor 
HZ Halbzeit 


Der Makroaufruf könnte in einem Programm so geschrieben werden: 


ЗАМ FTBAL ВВ 
FTBAL FT 
UME FTBAL HZ 


Text 


Ein Textoperand wird als Folge von alphanumerischen Zeichen geschrieben, die in Apostrophe 
eingeschlossen werden. Leerzeichen und spezielle Zeichen sind erlaubt. Textoperanden 
dürfen nicht mehr als 127 Zeichen enthalten, inclusive der Apostrophe. Z.B.: 


' BEREICH, РСВ, 132, ,1256” 
Zeichen 


Der Zeichenoperand wird wie eine Zeichenfolge geschrieben. Kommas oder Leerzeichen sind 
nicht erlaubt. Die Zeichenfolge darf nicht in Apostrophe eingeschlossen werden. z.B.: 


CUBTDAVE+HEINZ+JOHN*830PMOT 
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А.6 Formate der Makroaufrufe (ОСАМ) 


Name Operanden 


[symbol] | YACB [, АРРМАМЕ=ге1ехр | 


SHARE DISCO 
| Ш | 
NSHARE NDISCO 
Г,АТТВ-( 
PRIMTASK LOGON 
(қатық d ! 
МОТАСК NLOGON 


|, DISNAME=relexp] 


[, РАОМАМЕ=ге1ехр] 
[, ЕМВ=ге1ехр| 
[,LINK=relexp|] 
PERM 
[ , LINKMOD= | 
ТЕМР 
|, LOGPASS=kennwort1] 
[,USEPASS=kennwort2] 
[,USEPW=kennwort3] 
NO 
[,VERIFY=4 PRIMARY ¢] 
SECONDARY 
|, DCAMVER=àbsexp] 


[symbol] | YAPPL anwendungsname 
(register) 


kettungsname 
‚LINK= 


(register) 
verteilungsname 
[ , DISNAME= ] 
(register) 
kennwor t1 
|, USEPASS= 
(register) 


kennwort2 
[ , USEPW= 


(register) 


kennwort3 
|, LOGPASS= 


(register) 
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Мате 


[symbol] 


[symbol] 


[symbol] 


[symbol] 


[symbol] 


Operation 


YCCB 


YCHANGE 


YCHANGE 


YCLOSE 


YCLSCON 


Operanden 
[PTNNAME=relexp] 
| PRONAME=relexp] 
| DEPROT=USER] 


|, 81Р-ге1ехр| 


USER 
ar | 
SYSTEM 
PHYS) [GETBS GETFC LCASE 
GH d d d 
ҒОЯМ| [NGETBS| INGETFC| [NLCASE 
PHYS) [НСОРҮ HOM EXTEND LOGC LACK 
ШЕП d d d , 1) 
PORN) | (МНСОРҮ| (МНОМ) I[NEXTEND| net) |МАСК 


|, LINK=relexp] 
РЕВМ 

[ , LINKMOD= | 
TEMP 

[, LOGPW=kennwort4] 


TRUNC) [SYSCODE) [APPSTART] [NSIGNAL 
те d d d d 
KEEP | (BINARY | [ANYSTART| [SIGNAL 


[,USERFLD=benutzerfeld] 
[,MAXLN=absexp] 


RPB=addr 
[,MAXLN=absexp] 


RPB=addr 

[,schlüsselwort=neuer wert, ....] 
ACB=addr - 

AID=(register) 


RPB=addr 


[,schlüsselwort=neuer vert... | 
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Мате Operanden 
[symbol] | YCONN partnername 
(register) 


kettungsname 
‚LINK= 


(register) 


prozname 
[ , PRONAME= 


(register) 


benutzerfeld 
[, USERFLD= 


(register) 


kennwort4 
[ , LOGPW= 


(register) 
[symbol ] YDCG CODEVAL=(codewert,....) 
[symbol] | YDIP | СОПЕ!М-арвехр | 
[,CODEPOS=absexp] 


[,CODEIND=caracter] 


[,DCG=(relexp,...)] 
[symbol] | YENB (СОМЕМП-ге1ехр | 
(,ЕХРН-ге1ехр | 
(,1060М-ге1ехр| 
[,LOSCON=relexp] 

[, PROCON=relexp] 
[,TACK=relexp] 
[,SECOND=relexp| 


[symbol] | YFORBID RPB=addr 


[,schlüsselwort=neuer wert, ... ] 
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Мате Operanden ә 


[symbol] YGENCB ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 
1 
[, COPIES= ] 
integer 
[ ,WAREA=addr ] 
| |, LENGTH=value] 
L 
[.МР= Н 
(Е, addr) 
‚schlüsselwort=anfangswert,.... ә 


[symbol] YINQUIRE RPB=addr 
[,schlüsselwort=neuer wert, .. . ] 


[symbol] | YMODCB ACB 
CCB 
DCG 
BLK= 
DIP 
ENB 
RPB 
, BLKADDR=addr 
E 
[,MF= ] 
(E,addr) ! 
‚schlüsselwort=neuer мегт,... 


[symbol] | YOPEN ACB=addr ә 


[symbol] | YOPNCON RPB=addr 

эрэ [,schlüsselwort=neuer wert, . . . | 
[symbol] | YPERMIT RPB=addr 

ныг [,schlüsselwort=neuer vert... | 


А6 - 4 ОСАМ У8.0А DCAM Makroaufrufe, U987-J-275-2 


Мате Operanden 
[symbol] | YRECEIVE | RPB=addr 

Per [,schlüsselwort=neuer wert,...] 
[symbol] | YREJLOG RPB=addr 

T [,schlüsselwort=neuer wert,...] 
[symbol] | YRESET RPB=addr 

T [,schlüsselwort=neuer wert,...] 


[symbol] | YRPB 


[AAREA=relexp] 
[,AAREALN=absexp] 
[,ACB=relexp] 
[,AREA=relexp] 
[,AREALN=absexp] 
[,CCB=relexp] 
(,ЕШ-ге1ехр | 


[,EIDREF=information] 


ACCEPT BELL CS 
тон ET lam, 
ACQUIRE NBELL СА 


| ELEMENT NORMAL 0 
„рвов 2 f 2 ! 
GROUP EXPRESS ма 


REQLOGON 
TOPLOGON 
NAMXLATE SPEC START 

Г, 4 COUNTPTN IE h | | 
АРР5ТАТ 
CIDXLATE 
PTNCHAR 


SYN TACK TRUNC] ` 
2 d d d 
ASY NTACK CCBTK 


ANY STOP 


[,SEQNO=absexp] 
[, TOVAL=absexp] 


[symbol] | YSEND RPB=addr 


[,schlüsselwort=neuer мег, ... | 
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А6-6 


Мате Operation | Operanden 


[symbol] | YSENDREC RPB=addr 


[,schlüsselwort=neuer wert, . . . ] 


[symbol] | YSETLO RPB=addr 


[,schlüsselwort=neuer wert, . . . | 


[symbol] | YSHOWCB ACB 


, BLKADDR=addr 
, WAREA=addr 


, LENGTH=value 


L 
(el, ll 
(E,addr) 


schlüsselwort 
‚FIELDS= 


[symbol] | YTESTCB ACB 


‚ BLKADDR=addr 


|,ЕВЕТ-аааг | 


L 
ac) N 
(E,addr) 


‚schlüsselwort=testwert 


со 

7 

ж 

Il 
= гп оз оо 
"H = н оо 
со шо -0 Сә со 


(schlüsselwort, . 


4 
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Kontrollblöcke und Rückmeldungen: Namen für Felder und Werte 


Makro YDDACB 


Mit dem Makroaufruf YDDACB kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 
Steuerblock ACB angelegt werden. 


Format 
Name Operanden 
[symbol] | YDDACB D 
1-1 
С 
[ prefix] 
Y 
[,Е00=5 +] 
N 
Operanden 
symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDACB'’ erzeugt. 
D gibt an, was generiert werden soll: 
D verlangt die Generierung eines Pseudoabschnitts 
м С es wird ein Abschnitt generiert. 
prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 
vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDA’ 
jeweils dem symbolischen Namen vorangestellt. 
EQU=Y bedeutet, daß für alle möglichen Werte des Feedback-Feldes symboli- 
sche Größen vergeben werden (siehe auch YDDFDB). 
EQU=N es werden keine symbolischen Größen für die Werte des Feedback- 


Feldes vergeben. 
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Pseudoabschnitt DSECT für den Steuerblock АСВ 


YDDACB DSECT 

* 

* 

ж 

YDDAHDTY DC CL3’ACB’ 
YDDAHDD DC CL1’D’ 
YDDAHDCB DC '04' 
YDDAHDLN DC 

ж 

ж 

ж 

YDDAAPPN DS A 
YDDADISN DS А 
YDDAENB DS A 
YDDAAID DS OF 
YDDAASN DS H 
YDDAALN DS H 

ж 

YDDAAT1 DS LAN 

* 

YDDAATSH EQU Х'80' 
YDDAATLO EQU Х'40' 
YDDAATDI EQU Х'20' 
YDDAATSE EQU X’10’ 
* 

YDDAATTA DS XL1 

ж 

YDDARECT EQU X’04’ 
YDDAPRIT EQU Х'02' 
YDDANOTK EQU .Х 01” 
ж 

YDDAVERI DS XL1 

ж 

YDDANO EQU ` AO) 
YDDAPRIM EQU Х'02' 
YDDASEC EQU Х'04' 
ж 

YDDAOPT DS CL1 

* 

YDDAPERM EQU Х'02' 
YDDAACL5 EQU Х'04' 
YDDADCL5 EQU X’08’ 
* 

YDDALINK DS A 
YDDALGPA DS A 
YDDAPSSO DS F 
YDDAPWO DS F 

* 

YDDAFDBK YDDFDB ,YDDA 
YDDAFDBK DS ОЕ 

* 

цо. * Yc * ХХ 
YDDAFDB1 DS XL1 

* 

YDDASUCC EQU X’00’ 
YDDASUWA EQU Х'04' 
YDDARAPS Е00 Х'08' 
YDDARPTS EQU Х'0С' 
YDDARDCS EQU Х'10' 
YDDAINRU EQU Х'14' 
YDDARPAR EQU Х'18' 
YDDABCBR EQU Х'20' 
YDDASYSX EQU X'CC' 


ж 


HEADER OF CONTROL BLOCK (АСВ) 


TYPE OF 
DCAM CO 


CONTROL BLOCK 
NTROL BLOCK 


DCAM INTERFACE VERSION 


AL2(YDDALEN-(*+2-YDDAHDTY) ) LENGTH ОҒ BODY ОҒ CNT. BLOC 


BODY OF CONTROL BLOCK (ACB) 


A(APPNAME) 
A(DISNAME) 


A(ENB) 


APPLICATION IDENTIFIER (AID) 


BYTE 1 


ATTR 
ATTR 
ATTR 
ATTR 


BYTE 


N 


ATTR 
ATTR 
ATTR 


BYTE FO 


VERIFY 
VERIFY 
VERIFY 


LINKMOD 
FOR INT 


A(LINK) 
LOGPASS 
USEPASS 
USEPW 


FOR ATTR 


NSHARE (IF BIT=1: N..!) 
NLOGON (IF BIT=1: N..!) 
NDISCO (IF BIT=1: N..!) 
SESSION 


FOR ATTR 
REQTASK 
PRIMTASK 
NOTACK 

R VERIFY 
NO 


PRIMARY 
SECONDARY 


= PERM 
ERNAL USE 


FEEDBACK FIELD 1 x*****@+ xx sk x x k k жокк k k k kk kkk k kkk kkk ke ke e oke ke 


GENERAL 


REQUEST 
REQUEST 
REQUEST 
REQUEST 
REQUEST 
INVALID 
REQUEST 


RETURN CODE (IN R15 ТОО 


SUCCESSFULLY 

COMPLETED WITH WARNING 
REJ. DUE TO APP. STATE 
REJ. DUE TO PART. STATE 
REJ. DUE TO DCS STATE 
REQUEST USAGE 

REJ. DUE TO BAD PARAM 


BAD CONTROL BLOCK/PL (REFERENCE 


RESERVE 


D FOR SYSTEM EXITS 
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************** FEEDBACK FIELD 2 хххххххххххххххххххххххххххххххххХхххж 


YDDAFDB2 


ж 
YDDAFD2N 
* 

* 

* 
YDDANOTO 
YDDAALRO 
YDDANOSH 
YDDAONEO 
YDDAVERO 
YDDASECO 
YDDADIS 
YDDAFCLW 
YDDAFCL 
YDDAFCLD 
YDDAFCEP 
YDDAFCSE 
YDDAFCLT 
YDDAFCLP 
YDDAFCRS 
YDDATMAR 
YDDANACT 
YDDAIUPW 
YDDAANUM 
YDDANPRE 
YDDAIRDF 
YDDAOPSS 
YDDANPRD 
YDDACNPA 
YDDAISVR 


* 

ж 

ж 
YDDANCON 
YDDAACON 
YDDALOGQ 
YDDAIDID 
YDDAILID 
YDDACLUR 
YDDAFDIS 
YDDAPCSP 
YDDAPCSS 
YDDAPCST 
YDDAPCA 
YDDAMESL 
YDDAWRCP 
YDDASQUS 
YDDANOEX 
YDDANUSD 
YDDAIPAR 
YDDASYTI 
YDDAPNAV 
YDDAPSTP 
YDDAPNLG 
YDDAILPW 
YDDAREJL 
YDDAPCNA 
YDDAISSE 
YDDAPSTR 
YDDAPNVT 
YDDAPDED 
YDDANDCG 
YDDAIDIS 


* 


YDDASYER 


DS 


EQU 


XL1 


A 00’ 


REASON FOR REJECTION 


NO INDICATION IN FDBK-FIELD 2 


THE FOLLOWING EQUATES ARE VALID IF RAPS IS SET 


IN FEEDBACK FIELD 1 


APPLICATION NOT OPENED 
APPLICATION ALREADY OPENED 
APPLICATION IS NON SHARABLE 
NO MORE THAN ONE OPEN IS ALLOWE 
WRONG OPEN FOR PRIMARY TASK 
WRONG OPEN FOR SECONDARY TASK 
DISTRIBUTION ALREADY PERMITTED 
FORCED APPL. CLOSING WARNING 
FORCED APPL. CLOSING 
FORCED CLOSING — DCAM ERROR 
FORCED CLOSING-INV CONT BY PRIM 
FORCED CLOSING-INV CONT BY SEC 
FORCED CLOSING - TERM OF PRIMAR 
FORCED CLOSING BY PRIMARY TASK 
FORCED CLOSING BY SECONDARY TAS 
TOO MANY REQUESTS PENDING 
APPLICATION NOT ACTIVE 
INVALID USEPW 
TOO MANY APPL. OPENED 

ТОО MANY NON-PREDEFINED APPL. /ТА5 
INVALID PASSWORD FOR RDF 

APPL. OPENED BY ANOTHER SUBSYSTE 

TOO MANY NON-PREDEF. APPL. 
ТОО MANY CONN. /NONPREDEF . APPL. 
INVALID DCAMVER OF SECONDARY 


THE FOLLOWING EQUATES ARE VALID IF RPTS IS SET 


IN FEEDBACK FIELD 1 


Х'04' 
Х”08” 
Х”ОС” 
Х'10' 
Х'14' 
A 18 
KAC 
Х'20' 
Х' 24' 
Х'28' 
Х'2С' 
X'30' 
X'34' 
X'38' 
X'3C' 
X'40' 
Х'44' 
Х'48' 
A AL 
Х'50' 
Х'54' 
Х'58' 
X'5C' 
X'60' 
Х' 64' 
A 68” 
X'6C' 
Х'70' 
Х'74' 
Х'78' 


Х'80' 
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PARTNER NOT CONNECTED TO APPL. 
PARTNER ALREADY CONNECTED 
LOGON REQUEST QUEUED 

INVALID DID 

INVALID LID 

CNNECTION CLOSED BY USER REQUES 
PARTNER FORCED DISCONNECTED 
PARTNER IN CS STATE PENDING 
CHANGE TO CA NOT ALLOWED 
PARTNER IN CS FOR ANOTHER TASK 
PARTNER IN CA STATE 

MESSAGE IS TOO LONG 

WRONG CODE POSITION 
SEQUENCE# ALREADY USED 
EXPRESS NOT ALLOWED 

NO USER DATA WITH REJLOG 
INVALID DEPROT/EDIT 

SYSTEM TIMEOUT 

PARTNER NOT AVAILABLE 
PARTNER IN STOP STATE 
PARTNER IN NLOGON STATE 
INVALID LOGPW 

REQUEST REJECTED 

PTNCHAR NOT ACCEPTED BY PTN 
INVALID STAT.SERV.ELMT DATA 
РТМ IN STOP; REOCON FOLLOWS 
ERR IN ACTIVATING. PTN’S VTSU 
PARTNER ALREADY DEDICATED 

NO DCG 

IMMEDIATELY DISCONNECTED 
AFTER ACCEPTANCE 

SYNTAX ERROR IN USER MSG 


A7-4 


YDDANONA EQU 
YDDAAPCO EQU 
YDDAIPSW EQU 
YDDARCOS EQU 
YDDARPRI EQU 
YDDAPPRE EQU 
YDDARADM EQU 


* 
ж 
ж 


YDDASHOR EQU 
YDDASHUT EQU 
YDDAQSHU EQU 
YDDAIACT EQU 
YDDADCSE EQU 
YDDADCLK EQU 


* 
ж 
ж 


YDDAIRSE EQU 
YDDAIRNS EQU 
YDDAIRNL EQU 
YDDAERPE EQU 
YDDANAUT EQU 
YDDASYNQ EQU 


* 
ж 
ж 


YDDAIACB EQU 
YDDAICCB EQU 
YDDAIDCG EQU 
YDDAIDIP EQU 
YDDAIENB EQU 
YDDAIAAD EQU 
YDDAIDAD EQU 
YDDAIPAD EQU 
YDDAICOI EQU 
YDDAIEVI EQU ° 
YDDAIARA EQU 
YDDAIAAR EQU 
YDDAIAPN EQU 
YDDAIDIN EQU 
YDDAIPTN EQU 
YDDAIPRO EQU 
YDDACCBA EQU 
YDDASEQH EQU 
YDDAWRLN EQU 
YDDAISUB EQU 
YDDAIPRN EQU 
YDDANGAR EQU 
YDDAEDER EQU 
YDDAICDL EQU 
YDDAIPCL EQU 
YDDAIPCA EQU 


* 

اد عاد Ж‏ عا хх х‏ اج کا عاو کاو عاو 
YDDAFDB3 DS‏ 

* 

* 

* 


YDDANORM EQU 
YDDAMTRN EQU 
YDDAMKEP EQU 
ж 

YDDAPTSK EQU 
YDDASTSK EQU 


* 


X'84' 
X88 
Х'8С' 
X'90' 
X'94' 
X'98' 
A HL 


UNKNOWN AUTHORIZATION NAME 
APPLICATION ALREADY CONNECTED 
INVALID PASSWORD 

PROPOSED GROS REJECTED BY PTN 
PROP. NETW.PRIO REJ’D BY PTN 
РТМ PROCESS ERR (X.25EVENT,..) 
CONN.REQ. REJECTED BY ADMIN. 


THE FOLLOWING EQUATES ARE VALID IF RDCS IS SET 


IN FEEDBACK FIELD 1 


X'04' 
X'08' 
A OC 
Х'10' 
Х'14' 
Х'20' 


DCS SHORTAGE OF RESOURCES 
DCS SHUTDOWN WARNED 

DCS QUICK SHUTDOWN 

DCS INACTIVE 

DCS ERROR 

DCAM IS LOCKED 


THE FOLLOWING EQUATES ARE VALID IF INRU IS SET 


IN FEEDBACK FIELD 1 


Х'04' 
X'08' 
A UL 
Х'10' 
Х'14' 
Х'18' 


INVALID REQUEST FOR SECONDARY 
NOT ALLOWED FOR NONSHARE APPL. 
NOT ALLOWED WITH ATTR. NLOGON 
EQUIVALENT REQUEST PENDING 
APPICATION NOT AUTHORIZED 

SYN REQUEST ALREADY QUEUED 


THE FOLLOWING EQUATES ARE VALID IF RPAR IS SET 


IN FEEDBACK FIELD 1 


Х”04” 
Х”08” 
A UC 
Х'10' 
Х'14' 
Х'18' 
Х'1С' 
Х'20' 
Х' 24' 
Х'28' 
Х'2С' 
X'30' 
X'34' 
X'38' 
X'3C' 
Х'40' 
Х'44' 
Х'48' 
A ALT 
Х 50: 
Х'54' 
Х'58' 
A BL 
A GU 
X 64' 
Х'68' 


INVALID АСВ ADDRESS 

INVALID CCB ADDRESS 

INVALID DCG ADDRESS 

INVALID DIP ADDRESS 

INVALID ENB ADDRESS 

INVALID APPNAME ADDRESS 
INVALID DISNAME ADDRESS 
INVALID PTNNAME ADDRESS 
INVALID CONTINGENCY ID. ADDRESS 
INVALID EVENT ITEM ID. ADDRESS 
INVALID AREA ADDRESS 

INVALID AAREA ADDRESS 

INVALID APPLICATION NAME 
INVALID DISTRIBUTION NAME 
INVALID PARTNER NAME 

INVALID PROCESSOR NAME 

CCB REFERRED TO BY ASYNCHR. 
SEQUENCE NUMBER TOO HIGH 
AAREALN LESS THAN 8 / AREALN = 
INVALID SUBFUNCTION 

INVALID PRONAME ADDRESS 
NEGATIVE AREALN 

EDITING ERROR 

INVALID CODELN 

PTNCHLN LESS 4 BYTES 

APTNCH INVALID 


FEEDBACK FIELD З žžk xxx x x xex k de ke KKK KK kk kk ЖЖЖ ЖК k k ke ЖК k k 


XL1 


INDICATORS 


THE FOLLOWING EQUATES ARE VALID IF SUCC IS SET 


IN FEEDBACK FIELD 1 


X'00' 


MESSAGE NOT TOO LONG 
MESSAGE TRUNCATED 
REMAINDER OF MESSAGE IS KEPT 


TASK IS PRIMARY 
TASK IS SECONDARY 
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ж 
ж 


YDDACODE 
YDDANOIN 
YDDANOLO 
YDDATOUT 
YDDALDAT 
YDDALOCT 
YDDALMTR 
YDDAEDTE 
YDDAPTTR 
YDDAOUTR 
YDDAEDIV 
YDDATRES 
YDDAILHC 
YDDAINLC 


* 
ж 
ж 
ж 


YDDATRYL 
YDDABSHO 
YDDAWTGO 
YDDANOCB 
YDDANOID 
YDDANMEM 
YDDAPTSH 


ж 
ж 
ж 
ж 


YDDAEDPE 
YDDADVHD 
YDDAMSGL 


ж 


ххх ӘӘ ХХ 


YDDAFDB4 


* 
YDDAFD4N 
ж 
ж 
ж 


YDDAMSG 
YDDAGO 
YDDAPTCK 
YDDANTCK 
YDDAEXPD 
YDDAELMT 
YDDASGRP 
YDDAGRUP 
YDDALNF 


* 
* 


* 


YDDAPCN 
YDDADVER 
YDDAV70 
YDDAV80 
YDDARES5 
YDDALEN 


EQU 
EQU 
EQU 
DS 


EQU 


EQU 
EQU 


THE FOLLOWING EQUATES ARE VALID IF SUWA IS 
SET IN FEEDBACK FIELD 1 


Х'04' CONTRADICTION IN DATA CODE 
X'08' NO INPUT AVAILABLE 

X OC’ NO LOGON REQUEST QUEUED 

Х'10' REQUEST CANCELED BY TIMEOUT 
X'14' 1055 OF DATA DUE TO TIMEOUT 
Х'18' LOGON REQUEST CANCELED - TIMEOU 
Х'20' LOGON MESSAGE TRUNCATED 

Х' 24' EDIT ERROR OCCURRED 

X'28' PTNCHAR TRUNCATED 

Х'2С' OUTPUT TRUNCATED 

X'30' INVALID EDIT OPTIONS 

X'34' REQUEST TERMINATED BY YRESET 
Х'44' LOCAL HARDCOPY МОТ ASSIGNED 

A A8 NEW LINE CHAR. WHILE EXTEND=Y 


THE FOLLOWING EQUATES ARE VALID IF 
RDCS IS SET IN FEEDBACK FIELD 1 AND 
SHOR IS SET IN FEEDBACK FIELD 2 


Х'04' BCAM: TRY 1/0 LATER 

X'08' BCAM: SHORTAGE OF RESOURCES 

X OC BCAM: WAIT FOR GO 

Х'20' DCAM: NO CONTROL BLOCK AVAILABL 
Х' 24' DCAM: NO ID-ENTRY AVAILABLE 
Х'28' ПСАМ: NO MEMORY AVAILABLE 

Х'2С' ПСАМ: SH.RES. АТ PTN’S SYSYTEM 


THE FOLLOWING EQUATES ARE VALID IF 
RPAR IS SET IN FEEDBACK FIELD 1 AND 
EDER IS SET IN FEEDBACK FIELD 2 


X'00' EDIT PARAM ERROR 
Х'04' INVALID DEVICE HEADER 
X'08' LENGTH OF RECEIVED MESSAGE = O 


FEEDBACK FIELD 4 xxx e e e xe xe xe de de de e e e e e Fe Fe e Fe Fe e He He e Ж Ж k k k 
XL1 DATA INDICATORS 
X’ 00 NO INDICATION IN FDBK-FIELD 4 


THE FOLLOWING EQUATES ARE VALID IF SUCC OR SUWA 
ARE SET IN FEEDBACK FIELD 1 


Х'01' МЕЅЅАСЕ 

Х'02' GO-SIGNAL 

Х'04' POSITIVE ТАСК 

Х'08' МЕСАТІМЕ ТАСК 

Х'10' EXPRESS DATA 

Х'20' DATA ITEM IS A ELEMENT 
Х'40' LAST ELEMENT OF SUBGROUP 
X'80' LAST ELEMENT OF GROUP 
*—YDDAFDB1 LENGTH OF FEEDBACK INFO 
*,YDDFDB 453 840411 55616014 

A A(PRONAME) 

Y DCAM FUNCTIONAL VERSION#+ 
X’ 0000 VERSIONS LESS/EQUAL 7.0 
X' 0800 VERSION 8.0 

DH RESERVED 

*-YDDAHDTY LENGTH OF CONTROL BLOCK 
ж, ҮППАСВ 470 840719 55616011 
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-А7-5 


Makro YDDCCB 


Mit dem Makroaufruf YDDCCB kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 
Steuerblock CCB angelegt werden. 


Format 
Name Operanden 
[symbol] | YDDCCB D 
Ad 
С 
(,ргеҒіх| 
Operanden 
symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDCCB’ erzeugt. 
D gibt an, was generiert werden soll: 
verlangt die Generierung eines Pseudoabschnitts 
С С es wird ein Abschnitt generiert. 
prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 


vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDC' 
jeweils dem symbolischen Namen vorangestellt. 
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Pseudoabschnitt DSECT für den Steuerblock CCB 


YDDCCB 


* 
* 
ж 


YDDCHDTY 
YDDCHDD 

YDDCHDCB 
YDDCHDLN 


ж 
ж 
ж 


YDDCCID 
YDDCPTN 
YDDCPAWO 
YDDCUSER 
YDDCPCN 


ж 


YDDCITRA 
* 

YDDCITLI 
YDDCITPH 
YDDCITFO 


* 


YDDCIT2 
* 
YDDCISPA 
YDDCILCA 
YDDCIGET 


* 


YDDCOTRA 
* 

YDDCOTLI 
YDDCOTPH 
YDDCOTFO 


* 


YDDCOCOP 
* 
YDDCOHCP 
YDDCOHOM 
YDDCOEXT 
YDDCOLOG 
YDDCOLAK 
* 
YDDCDIP 
YDDCDID 
YDDCDSN 
YDDCDLN 


* 


YDDCFLG1 
ж 
YDDCTRUN 
YDDCKEEP 
YDDCCBK 
ж 
YDDCFLG2 
ж 

ж 


YDDCPRCO 
YDDCPRST 
YDDCPRSI 


* 


YDDCFLAG 


* 


YDDCFLG3 


DSECT 


DS 


HEADER OF CONTROL BLOCK (CCB) | 


CL3’CCB’ TYPE OF CONTROL BLOCK 
CL1’D’ DCAM CONTROL BLOCK 
'04' DCAM INTERFACE VERSION+ 


AL2(YDDCLEN-(*+2-YDDCHDTY)) LGTH OF BODY OF CNT. BLOCK 


BODY OF CONTROL BLOCK (CCB) 


XL4 CID 

A А(РТММАМЕ) 

А LOGPW 

XL4 USERFLD 

A A(PRONAME) 

XL1 BYTE 1 FOR EDITIN 
Х'01' EDITIN = LINE 
Х'02' EDITIN = PHYS 
X'04' EDITIN = FORM 

XL1 BYTE 2 FOR EDITIN 
X'80' EDITIN = GETBS 
X'40' EDITIN = LCASE 
Х'20' EDITIN = GETFC 
XL1 BYTE 1 FOR EDITOUT 
Х'01' EDITOUT = LINE 
Х'02' EDITOUT = PHYS 
Х'04' EDITOUT = FORM 
XL1 BYTE 2 FOR EDITOUT 
X'80' EDITOUT = HCOPY 
Х'40' EDITOUT = НОМ 
Х'20' EDTITOUT=EXTEND 
X'10/ EDTITOUT=NLOGC 
X'08' EDTITOUT=LACK 

A A(DIP) 

OF DID 

H 

H 

LA FLAGBYTE 1 

Х'04' PROC = TRUNC 
Х'02' PROC = KEEP 

Х'01' 

XL1 FLAGBYTE 2 

X'80' PROC = BINARY 
X'40' PROC = APPSTART 
Х'20' PROC = SIGNAL 

XL1 ACTIVE FLAG 

XL1 FLAGBYTE 3 
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A7-7 


ж 


YDDCPDXP 
YDDCPED 
YDDCPPST 
YDDCPCL5 
YDDCACL5 
YDDCPERM 
YDDCDIFL 
ж 
YDDCLINK 
YDDCMXLN 


ж 
ж 


YDDCDXP 


ж 


YDDCDUS 


ж 


YDDCED 

* 
YDDCEDUS 
YDDCEDSY 
YDDCEDSM 
* 
YDDCPCH1 
YDDCPTYP 
YDDCPDEV 
YDDCRES 


YDDCAPTC 
YDDCLPTC 
YDDCRES2 
YDDCLEN 


5H 


*—YDDCHDTY 
ж, YDDCCB 


PDPROT = SYSTEM 


PEDIT 
PPROC 


= SYSTEM 
= PTNSTART 


FOR INTERNAL USE 


LINKMOD = PERM 
DID IS USED 


A(LINK) 
MAXIMAL LENGTH OF MESSAGE 


BYTE 


FOR DEPROT 


DEPROT = USER 


BYTE 


EDIT 
EDIT 
EDIT 


FOR EDIT 


USER 
SYSTEM 
DSSIM 


PARTNER CHARACTERISTIC 
PARTNER TYP 
PARTNER DEVICE 


RESERVE 
FOR DSSIM: А(РТМСНАН) 
FOR DSSIM: L’PTNCHAR 
RESERVE 

LENGTH OF CONTROL BLOCK 


840719 


55616012 
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Makro YDDDCG 


Mit dem Makroaufruf YDDDCG kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 
Steuerblock DCG angelegt werden. 


Format 
Name Operanden 
[symbol] | YDDDCG D 
4 d 
С 
[‚,ргеї1х] 
Operanden 
symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDDCG'’ erzeugt. 
D gibt an, was generiert werden soll: 
D verlangt die Generierung eines Pseudoabschnitts 
С С es wird ein Abschnitt generiert. 
prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 


vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge "DD 
jeweils dem symbolischen Namen vorangestellt. 
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Pseudoabschnitt DSECT für den Steuerblock DCG 


YDDDCG DSECT 


ж 


ж HEADER OF CONTROL BLOCK (DCG) 

ж 

YDDGHDTY DC CL3’DCG’ TYPE OF CONTROL BLOCK 
YDDGHDD DC CL1'D' DCAM CONTROL BLOCK 
YDDGHDCB DC '04' ОСАМ INTERFACE VERSION+ 
YDDGHDLN DC AL2 (YDDGLEN- (*+2-YDDGHDTY)) LENGTH OF BODY 

* 

* BODY OF CONTROL BLOCK (DCG) 

* 

YDDGNCOD DS H NUMBER OF DISTRIBUTION CODES 
YDDGFLG1 DS CL1 FLAGBYTE 

ж 

YDDGCOM EQU Х80 CODE MODIFICATION 


* 


YDDGRES1 DS CL1 
YDDGCODE DS 0С18 DISTRIBUTION CODES: 


YDDGCOD1 DS сів 1. CODEVAL 
YDDGCOD2 05 CL8 2. CODEVAL 
YDDGCOD3 DS сіз 3. CODEVAL 
YDDGCODA 08 CL8 4. CODEVAL 
YDDGCOD5 DS С18 5. CODEVAL 
YDDGCOD6 08 сіз 6. CODEVAL 
үровсоо7 DS сів 7. CODEVAL 
YDDGCOD8 DS сіз 8. CODEVAL 

ж 

YDDGGID DS OF IDENTIFIER OF DCG 
YDDGGSN 05 H 

YDDGGLN DS н 

ж 

YDDGLEN EQU x-YDDGHDTY LENGTH OF CONTROL BLOCK 


ж, YDDDCG 450 831109 ` 55616017 
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Makro YDDDIP 


Mit dem Makroaufruf YDDDIP kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 
Steuerblock DIP angelegt werden. 


Format 
Name Operanden 
[symbol] | YDDDIP D 
| 
С 
[,prefix] 
Operanden 
symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDDIP' erzeugt. 
D gibt an, was generiert werden soll: 
D verlangt die Generierung eines Pseudoabschnitts 
С С es wird ein Abschnitt generiert. 
prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 


vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDD’ 
jeweils dem symbolischen Namen vorangestellt. 
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Pseudoabschnitt DSECT für den Steuerblock DIP 


YDDDIP 


* 
* 
ж 


YDDDHDTY 
YDDDHDD 

YDDDHDCB 
YDDDHDLN 


* 
ж 
ж 


YDDDCDPS 
YDDDCDLN 
YDDDCIND 
YDDDRES 
ж 
YDDDDID 
YDDDDSN 
YDDDDLN 
ж 
YDDDDCG 
YDDDDCG1 
YDDDDCG2 
YDDDDCG3 
YDDDDCG4 
YDDDDCG5 
YDDDDCG6 
YDDDDCG7 
YDDDDCG8 
YDDDDCG9Y 
YDDDDCGA 
YDDDDCGB 
YDDDDCGC 
YDDDDCGD 
YDDDDCGE 
YDDDDCGF 
YDDDDCGG 


ж 


YDDDLEN 


DSECT 


HEADER OF CONTROL BLOCK (DIP) 


СІЗ DIP’ TYPE ОҒ CONTROL BLOCK 
CL1’D’ DCAM CONTROL BLOCK 
CN DCAM INTERFACE VERSION# 


AL2 (YDDDLEN- (*+2-YDDDHDTY)) LENGTH OF BODY 
BODY OF CONTROL BLOCK (DIP) 

CODEPOS 

CODELN 

CODEIND 

RESERVED 


OF DISTRIBUTION IDENTIFIER 


“ТІ 


ADDRESSES ОҒ DCG’S 
A(DCG1) 
A(DCG2) 
А(0С63) 
A(DCG4) 
А(0С65) 
А(0С66) 
A(DCG7) 
А(0С68) 
A(DCG9) 
А(0С610) 
А(0С611) 
А(0С612) 
А(0С613) 
А(0С614) 
A(DCG15) 
A(DCG16) 


ттптт тт т т т т т т тп т т оО 


*-YDDDHDTY 
*,YDDDIP 


LENGTH OF CONTROL BLOCK 


450 840124 55616018 
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Makro YDDENB 


Mit dem Makroaufruf YDDENB kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 


Steuerblock ENB angelegt werden. 


Format 


Name Operanden 


[symbol] | YDDENB 


Operanden 


symbol 
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К 


|,ргеїїх| 


gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDENB’ erzeugt. 


gibt an, was generiert werden soll: | 
D verlangt die Generierung eines Pseudoabschnitts 
С es wird ein Abschnitt generiert. 


gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 
vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDE’ 
jeweils dem symbolischen Namen vorangestellt. 
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Pseudoabschnitt DSECT für den Steuerblock ЕМВ 


YDDENB 


* 
* 
* 


YDDEHDTY 
YDDEHDD 

YDDEHDCB 
YDDEHDLN 


* 
ж 
ж 


YDDECEND 
YDDEEXPR 
YDDELOGO 
YDDELOSC 
YDDEPROC 
YDDETACK 
YDDESECO 


ж 


YDDELEN 


DSECT 


>>>>>>> 


HEADER OF CONTROL BLOCK (ENB) 


CL3’ENB’ TYPE OF CONTROL BLOCK 
CL1’D’ DCAM CONTROL BLOCK 
'04' DCAM INTERFACE VERSION: 


AL2(YDDELEN-(*+2-YDDEHDTY)) LENGTH OF BODY ОҒ CNT. BLOC 
BODY OF CONTROL BLOCK (ENB) 


A(COMEND CONTINGENCY 
A(EXPR CONTINGENCY 
A(LOGON CONTINGENCY 
A(LOSCON CONTINGENCY 
A(PROCON CONTINGENCY 
A(TACK CONTINGENCY 
A(SECOND CONTINGENCY 


*-YDDEHDTY 
ж, YDDENB 


LENGTH OF CONTROL BLOCK 


450 831109 55616016 
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Makro YDDRPB 


© Mit dem Makroaufruf YDDRPB kann ein (Pseudo-)Abschnitt (CSECT oder DSECT) für den 
Steuerblock RPB angelegt werden. 


Format 
Name Operanden 
[symbol] | YDDRPB D 
1-1 
С 
[ prefix] 
Y 
[,Е00=5 +] 
N 
Operanden 
© symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine 
Adresse angegeben, so wird die Adresse 'YDDRPB' erzeugt. 
D gibt an, was generiert werden soll: 
D verlangt die Generierung eines Pseudoabschnitts 
С С es wird ein Abschnitt generiert. 
prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die den Namen 
vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDR' 
jeweils dem symbolischen Namen vorangestellt. 
EQU=Y bedeutet, daß für alle möglichen Werte des Feedback-Feldes symboli- 
sche Größen vergeben werden (siehe auch YDDFDB). 
EQU=N es werden keine symbolischen Größen für die Werte des Feedback- 


Feldes vergeben. 


L 
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А7 - 16 


Pseudoabschnitt DSECT für den Steuerblock ВРВ 


YDDRPB 


* 
* 
* 


YDDRHDTY 
YDDRHDD 

YDDRHDCB 
YDDRHDLN 


* 

* 

* 
YDDRROT 
* 
YDDRNORQ 
YDDROPNC 
YDDRCLSC 
YDDRRSET 
YDDRREJC 
YDDRSETL 
YDDRCHAN 
YDDRINQU 
YDDRPMIT 
YDDRFBID 
YDDRSD 
YDDRRC 
YDDRSDRC 
YDDRSESS 


ж 


YDDRFLAG 


* 


YDDRACTI 


ж 


YDDRSWIT 
ж 

YDDRCIFL 
YDDRAIFL 


ж 


YDDROPC1I 
* 
YDDRSPEC 
YDDRCS 
YDDRQ 
YDDRASY 
YDDRACQ 
YDDRPASS 
YDDRRLRQ 
YDDRSTAR 


* 


YDDROPC2 
ж 

YDDRPCHA 
YDDRLOMS 
YDDRTOPL 
YDDRCOUN 
YDDRASTA 
YDDRCIDX 
YDDRNAMX 
YDDRREOB 
YDDRTOPB 
YDDRMODX 


* 


YDDROPC3 


* 


YDDRELEM 


DSECT 


HEADER OF CONTROL BLOCK (RPB) 


CL3’RPB’ TYPE OF CONTROL BLOCK 
CL1' D' DCAM CONTROL BLOCK 
"04” DCAM INTERFACE VERSION+ 


AL2 (YDDRLEN-(*+2-YDDRHDTY)) LGTH OF BODY ОҒ CNT. BLOCK 


BODY OF CONTROL BLOCK (RPB) 


XL1 


REQUEST TYPE: 


NO REQUEST 

OPEN CONNECTION REQUEST 
CLOSE CONNECTION REQUEST 
RESET REQUEST 

REJECT CONNECTION REQUEST 
SET LOGON REQUEST 

CHANGE REQUEST 

INQUIRE REQUEST 

PERMIT REQUEST 

FORBID REQUEST 

SEND REQUEST 

RECEIVE REQUEST 
SEND/RECEIVE REQUEST 
SESSION REQUEST 


STATUS BYTE FOR CONTROL BLOCK 
RPB IS USED BY REQUEST 
USED PARAMETER FOR R EQUEST 


CID IS USED 
AID IS USED 


BYTE 1 FOR OPTCD 


OPTCD = SPEC 
OPTCD = CS 
ОРТСО = 0 

ОРТСО = ASY 
ОРТСО = ACQUIRE 
OPTCD = START 


BYTE 2 FOR OPTCD 


OPTCD = PTNCHAR 
OPTCD = REQLOGON 
OPTCD = TOPLOGON 
OPTCD = COUNTPN 
OPTCD = APPSTAT 
OPTCD = CIDXLATE 
- OPTCD = NAMXLATE 
OPTCD = REOBIND 
OPTCD = TOPBIND 
OPTCD = MODXLATE 


BYTE 3 FOR OPTCD 


OPTCD = ELEMENT 


DCAM М8.0А ОСАМ Makroaufrufe, 0987-.)-2775-2 


YDDRSUBG EQU Х'02' OPTCD = SUBGROUP 
© YDDRGRP ЕШ X'01' OPTCD = GROUP 
ж 
YDDROPC4 DS XL1 BYTE 4 FOR OPTCD 
ж 
YDDRTRUN EQU Х04 OPTCD = TRUNC 
YDDRKEEP EQU Х'02' OPTCD = KEEP 
YDDRCCBT EQU ` AO)" OPTCD = CCBTK 
ж 
YDDROPC5 DS AL) ВҮТЕ 5 FOR OPTCD 
* 
YDDREXPR EQU Х'80' OPTCD = EXPR 
YDDRTACK EQU X’40’ OPTCD = TACK 
YDDRBELL EQU Х'20' OPTCD = BELL 
YDDRFHSY EQU Х'10' FHS = YES (FOR DCUS ONLY !) 
* 
YDDRACB DS А А(АСВ) 
YDDRAID DS OF APPLICATION IDENTIFIER (AID) 
YDDRASN DS H 
YDDRALN DS H 
YDDRCCB DS А А(ССВ) 
YDDRCID DS OF CONNECTION IDENTIFIER 
YDDRCSN DS H 
© YDDRCLN DS H 
ж 
YDDRLID DS OF LOGON IDENTIFIER 
YDDRLSN DS H 
YDDRLLN DS H 
YDDRAR DS А А(АВЕА) 
YDDRARLN DS F AREALN 
YDDRAA DS A A(AAREA) 
YDDRAALN DS F AAREALN 
YDDRARCL DS F LENGTH OF DATA IN AAREA (ARECLN 
YDDRUSER DS F USER FIELD 
YDDRTOVA DS H TOVAL 
YDDRTCKN DS H SEQUENCE# OF RECEIVED TACK 
YDDRSON DS H SEQUENCE# FOR OUTPUT (5ЕОМО) 
YDDRASON DS H SEQUENCE# FOR INPUT (АЗЕОМО) 
YDDREID DS А А( EVENT ITEM IDENTIFIER ) 
YDDREIDR DS F EIDREF 
* 
YDDRFDBK YDDFDB ,YDDR,NEABI=NO 
YDDRFDBK DS OF 
ж 
ххжххжхжжжжжжжежеж FEEDBACK FIELD 1 že xx x x k kke k k k k dek k dek kK k k k dk жж k kk k k k 
© YDDRFDB1 DS XL1 GENERAL RETURN CODE (IN R15 TOO 
* 
YDDRSUCC EQU Х'00' REQUEST SUCCESSFULLY 
YDDRSUWA EQU Х04 REQUEST COMPLETED WITH WARNING 
YDDRRAPS EQU X’08’ REQUEST REJ. DUE TO APP. STATE 
YDDRRPTS EQU X’OC’ REQUEST REJ. DUE TO PART. STATE 
YDDRRDCS EQU X’10’ REQUEST REJ. DUE TO DCS STATE 
YDDRINRU EQU Х'14' INVALID REQUEST USAGE 
YDDRRPAR EQU Х'18' REQUEST REJ. DUE TO BAD PARAM 
YDDRBCBR EQU Х'20' BAD CONTROL BLOCK/PL (REFERENCE 
YDDRSYSX EQU X'CC' RESERVED FOR SYSTEM EXITS 
* 
ххжжхжхжжжжжжжжж FEEDBACK FIELD 2 * xxx žžk xk хх кок кк ж кк dek kk k kk k kk k k k 
YDDRFDB2 DS XL1 REASON FOR REJECTION 
. ж ' 
YDDRFD2N EQU Х 00” NO INDICATION IN FDBK-FIELD 2 
* 
* THE FOLLOWING EQUATES ARE VALID IF RAPS IS SET 
ж IN FEEDBACK FIELD 1 


YDDRNOTO EQU Х04 
YDDRALRO EQU Х'08' 
YDDRNOSH EQU ` A OC 


APPLICATION МОТ OPENED 
APPLICATION ALREADY OPENED 
APPLICATION IS NON SHARABLE 
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А7 - 18 


YDDRONEO 
YDDRVERO 
YDDRSECO 
YDDRDIS 
YDDRFCLW 
YDDRFCL 
YDDRFCLD 
YDDRFCEP 
YDDRFCSE 
YDDRFCLT 
YDDRFCLP 
YDDRFCRS 
YDDRTMAR 
YDDRNACT 
YDDRIUPW 
YDDRANUM 
YDDRNPRE 
YDDRIRDF 
YDDROPSS 
YDDRNPRD 
YDDRCNPA 
YDDRISVR 
ж 

ж 

ж 


YDDRNCON 


YDDRACON. 


YDDRLOGQ 
YDDRIDID 
YDDRILID 
YDDRCLUR 
YDDRFDIS 
YDDRPCSP 
YDDRPCSS 
YDDRPCST 
YDDRPCA 
YDDRMESL 
YDDRWRCP 
YDDRSQUS 
YDDRNOEX 
YDDRNUSD 
YDDRIPAR 
YDDRSYTI 
YDDRPNAV 
YDDRPSTP 
YDDRPNLG 
YDDRILPW 
YDDRREJL 
YDDRPCNA 
YDDRISSE 
YDDRPSTR 
YDDRPNVT 
YDDRPDED 
YDDRNDCG 
YDDRIDIS 
* 
YDDRSYER 
YDDRNONA 
YDDRAPCO 
YDDRIPSW 
YDDRRCOS 
YDDRRPRI 
YDDRPPRE 
YDDRRADM 


ж 


A 10 
Х' 14' 
Х'18' 
X'1C' 
Х'20' 
Х' 24' 
Х'28' 
Х'2С' 
X'30' 
X'34' 
X'38' 
X'3C' 
Х 40” 
X'44' 
X'48' 
A 4C" 
Х'50' 
Х'54' 
Х'58' 
X: DE’ 
X'60' 
Х' 64' 


NO MORE THAN ONE OPEN IS ALLOWE 
WRONG OPEN FOR PRIMARY TASK 
WRONG OPEN FOR SECONDARY TASK 
DISTRIBUTION ALREADY PERMITTED 
FORCED APPL. CLOSING WARNING 
FORCED APPL. CLOSING 
FORCED CLOSING - DCAM ERROR 
FORCED CLOSING-INV CONT BY PRIM 
FORCED CLOSING-INV CONT BY SEC 
FORCED CLOSING - TERM OF PRIMAR 
FORCED CLOSING BY PRIMARY TASK 
FORCED CLOSING BY SECONDARY TAS 
TOO MANY REQUESTS PENDING 
APPLICATION NOT ACTIVE 
INVALID USEPW 
TOO MANY APPL. OPENED 
TOO MANY NON-PREDEFINED APPL. /ТА5 
INVALID PASSWORD FOR RDF 
APPL. OPENED BY ANOTHER SUBSYSTE 
TOO MANY NON-PREDEF. APPL. 
TOO MANY CONN./NONPREDEF.APPL. 
INVALID DCAMVER OF SECONDARY 


THE FOLLOWING EQUATES ARE VALID IF RPTS IS SET 


IN FEEDBACK FIELD 1 


X'04' 
X'08' 
A OC 
A 10 
Х'14' 
Х'18' 
A 10” 
Х'20' 
Х'24' 
Х'28' 
Х'2С' 
A 30” 
X'34' 
Х'38' 
X'3C' 
X'40' 
A 44' 
A A8 
Х'4С' 
Х'50' 
Х'54' 
Х'58' 
Х'5С' 
A DUT 
A Dä 
A 68 
A 6C 
Х'70' 
X74" 
Х'78' 


Х'80' 
Х'84' 
Х'88' 
X 80” 
A 90” 
A 94” 
X’ 98” 
A HL 


PARTNER NOT CONNECTED TO APPL. 
PARTNER ALREADY CONNECTED 
LOGON REQUEST QUEUED 

INVALID DID 

INVALID LID 

CNNECTION CLOSED BY USER REQUES 
PARTNER FORCED DISCONNECTED 
PARTNER IN CS STATE PENDING 
CHANGE TO CA NOT ALLOWED 
PARTNER IN CS FOR ANOTHER TASK 
PARTNER IN CA STATE 

MESSAGE IS TOO LONG 

WRONG CODE POSITION 

SEOUEN Ee ALREADY USED 
EXPRESS NOT ALLOWED 

NO USER DATA WITH REJLOG 
INVALID DEPROT/EDIT 

SYSTEM TIMEOUT 

PARTNER NOT AVAILABLE 

PARTNER IN STOP STATE 

PARTNER IN NLOGON STATE 
INVALID LOGPW 

REQUEST REJECTED 

PTNCHAR NOT ACCEPTED BY PTN 
INVALID STAT.SERV.ELMT DATA 
PTN IN STOP; REOCON FOLLOWS 
ERR IN ACTIVATING PTN’S VTSU 
PARTNER ALREADY DEDICATED 

NO DCG 

IMMEDIATELY DISCONNECTED 
AFTER ACCEPTANCE 

SYNTAX ERROR IN USER MSG 
UNKNOWN AUTHORIZATION NAME 
APPLICATION ALREADY CONNECTED 
INVALID PASSWORD 

PROPOSED GROS REJECTED BY PTN 
PROP. NETW.PRIO REJ'D BY PTN 
РТМ PROCESS ERR (X.25EVENT,..) 
CONN.REQ. REJECTED BY ADMIN. 


THE FOLLOWING EQUATES ARE VALID IF RDCS IS SET 


IN FEEDBACK FIELD 1 
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YDDRSHOR 
YDDRSHUT 
YDDROSHU 
YDDRIACT 
YDDRDCSE 
YDDRDCLK 


* 
ж 


ж 


YDDRIRSE 
YDDRIRNS 
YDDRIRNL 
YDDRERPE 
YDDRNAUT 
YDDRSYNQ 


* 

* 

* 

YDDRIACB 
YDDRICCB 
YDDRIDCG 
YDDRIDIP 
YDDRIENB 
YDDRIAAD 
YDDRIDAD 
YDDRIPAD 
YDDRICOI 
YDDRIEVI 
YDDRIARA 
YDDRIAAR 
YDDRIAPN 
YDDRIDIN 
YDDRIPTN 
YDDRIPRO 
YDDRCCBA 
YDDRSEQH 
YDDRWRLN 
YDDRISUB 
YDDRIPRN 
YDDRNGAR 
YDDREDER 
YDDRICDL 
YDDRIPCL 
YDDRIPCA 


* 


хх л» T ХХ‏ عاو جا عاج عار عا عاو 


YDDRFDB3 


* 
* 
* 


YDDRNORM 
YDDRMTRN 
YDDRMKEP 
* 

YDDRPTSK 
YDDRSTSK 


* 
* 
* 


YDDRCODE 
YDDRNOIN 
YDDRNOLO 
YDDRTOUT 
YDDRLDAT 
YDDRLOCT 
YDDRLMTR 
YDDREDTE 


DS 


X'04' 
LACH 
Х'0С' 
Х'10' 
Х'14' 
Х'20' 


DCS SHORTAGE OF RESOURCES 
DCS SHUTDOWN WARNED 

DCS QUICK SHUTDOWN 

DCS INACTIVE 

DCS ERROR 

DCAM IS LOCKED 


THE FOLLOWING EQUATES ARE VALID IF INRU IS SET 


IN FEEDBACK FIELD 1 


Х'04' 
X'08' 
Х'0С' 
Х'10' 
Х'14' 
Х'18' 


INVALID REQUEST FOR SECONDARY 
NOT ALLOWED FOR NONSHARE APPL. 
NOT ALLOWED WITH ATTR. NLOGON 
EQUIVALENT REQUEST PENDING 
APPICATION NOT AUTHORIZED 

SYN REQUEST ALREADY QUEUED 


THE FOLLOWING EQUATES ARE VALID IF RPAR IS SET 


IN FEEDBACK FIELD 1 


Х'04' 


ë 


` 


` ` ` ` 


INVALID ACB ADDRESS 

INVALID CCB ADDRESS 

INVALID DCG ADDRESS 

INVALID DIP ADDRESS 

INVALID ENB ADDRESS 

INVALID APPNAME ADDRESS 
INVALID DISNAME ADDRESS 
INVALID PTNNAME ADDRESS 
INVALID CONTINGENCY ID. ADDRESS 
INVALID EVENT ITEM ID. ADDRESS 
INVALID AREA ADDRESS 

INVALID AAREA ADDRESS 

INVALID APPLICATION NAME 
INVALID DISTRIBUTION NAME 
INVALID PARTNER NAME 

INVALID PROCESSOR NAME 

CCB REFERRED TO BY ASYNCHR. 
SEQUENCE NUMBER TOO HIGH 
AAREALN LESS THAN 8 / AREALN = 
INVALID SUBFUNCTION 

INVALID PRONAME ADDRESS 
NEGATIVE AREALN 

EDITING ERROR 

INVALID CODELN 

PTNCHLN LESS 4 BYTES 

APTNCH INVALID 


FEEDBACK FIELD З xxx xx x +< ke ks KKK k k k k k ke k k k k k k k kk kk kkk 


XL1 


INDICATORS 


THE FOLLOWING EQUATES ARE VALID IF SUCC IS SET 


IN FEEDBACK FIELD 1 


х'00' 
Х'04' 
X'08' 


X'00' 
Х'04' 


MESSAGE NOT TOO LONG 
MESSAGE TRUNCATED 
REMAINDER OF MESSAGE IS KEPT 


TASK IS PRIMARY 
TASK IS SECONDARY 


THE FOLLOWING EQUATES ARE VALID IF SUWA IS 


SET IN FEEDBACK FIELD 1 


Х'04' 
X'08' 
A OC’ 
A 10 
Х' 14” 
Х'18' 
Х'20' 
Х' 24' 
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CONTRADICTION IN DATA CODE 

NO INPUT AVAILABLE 

NO LOGON REQUEST QUEUED 

REQUEST CANCELED BY TIMEOUT 
LOSS OF DATA DUE TO TIMEOUT 
LOGON REQUEST CANCELED - TIMEOU 
LOGON MESSAGE TRUNCATED 

EDIT ERROR OCCURRED 


A7 - 19 


А7-20 


YDDRPTTR 
YDDROUTR 
YDDREDIV 
YDDRTRES 
YDDRILHC 
YDDRINLC 


* 
* 
ж 
ж 


YDDRTRYL 
YDDRBSHO 
YDDRWTGO 
YDDRNOCB 
YDDRNOID 
YDDRNMEM 
YDDRPTSH 


* 
* 
* 
ж 


YDDREDPE 
YDDRDVHD 
YDDRMSGL 


ж 


ххх лж х» х хх kk 


YDDRFDB4 


* 
YDDRFD4N 
* 
* 
ж 


YDDRMSG 
YDDRGO 
YDDRPTCK 
YDDRNTCK 
YDDREXPD 
YDDRELMT 
YDDRSGRP 
YDDRGRUP 
YDDRLNF 


* 
* 


* 
* 


YDDRLEN 


EQU 
EQU 
EQU 


DS 


EQU 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


DS 


EQU 


Х'28' PTNCHAR TRUNCATED 

Х'2С' OUTPUT TRUNCATED 

A 20" INVALID EDIT OPTIONS 

X'34' REQUEST TERMINATED BY YRESET 
Х' 44' LOCAL HARDCOPY NOT ASSIGNED 
Х'48' NEW LINE CHAR. WHILE EXTEND=Y 


THE FOLLOWING EQUATES ARE VALID IF 
RDCS IS SET IN FEEDBACK FIELD 1 AND 
SHOR IS SET IN FEEDBACK FIELD 


X'04' BCAM: TRY 1/0 LATER 

X'08' BCAM: SHORTAGE OF RESOURCES 

A OC’ BCAM: WAIT FOR GO | 

Х'20' ОСАМ: NO CONTROL BLOCK AVAILABL 
Х'24' DCAM: NO ID-ENTRY AVAILABLE 
Х'28' DCAM: NO MEMORY AVAILABLE 

Х'2С' ПСАМ: SH.RES. AT PTN’S SYSYTEM 


THE FOLLOWING EQUATES ARE VALID IF 
RPAR IS SET IN FEEDBACK FIELD 1 AND 
EDER IS SET IN FEEDBACK FIELD 2 


A 00” EDIT PARAM ERROR 
X'04' INVALID DEVICE HEADER 
X'08' LENGTH OF RECEIVED MESSAGE = 0 


FEEDBACK FIELD 4 že xe xe de de de sk sk sk sk sk Жо Жс k Жс EEE 


XL1 


х'00' 


DATA INDICATORS 


NO INDICATION IN FDBK-FIELD 4 


THE FOLLOWING EQUATES ARE VALID IF SUCC OR SUWA 
ARE SET IN FEEDBACK FIELD 1 


Х'01' MESSAGE 

Х'02' GO-SIGNAL 

Х'04' POSITIVE ТАСК 

Х'08' МЕСАТІМЕ ТАСК 

X'10' EXPRESS DATA 

Х'20' DATA ITEM IS A ELEMENT 
х'40' LAST ELEMENT OF SUBGROUP 
X'80' LAST ELEMENT OF GROUP 
*-YDDRFDB1 LENGTH OF FEEDBACK INFO 
*,YDDFDB 840411 55616014 

(18 RESERVE 

*-YDDRHDTY LENGTH OF CONTROL BLOCK 
*,YDDRPB 840719 55616013 
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Makroaufruf YDDFDB 


© Der Makroaufruf YDDFDB generiert einen Bereich von 4 Bytes, der für den Inhalt verschiede- 
ner Rückmeldungen vorgesehen ist. Wahlweise kann eine DUMMY-SECTION erzeugt werden. 
Die symbolischen Namen können als symbolische Adressen zur Auswertung der Rückmeldun- 
gen verwendet werden. 


Format 
Name Operanden 
[symbol] | YDDFDB D 
1-1 
С 
[ prefix] 
[,4CONT}] | 
CBRC 


© Operanden 


symbol gibt die symbolische Adresse für den Makroaufruf an. Wird keine Adresse 
angegeben, so wird die Adresse "YDDFFDBK” erzeugt. 


D gibt an, was generiert werden soll: 
C verlangt die Generierung einer DUMMY-SECTION; 
С D verlangt die Generierung eines Bereichs von 4 Bytes Länge. 


prefix gibt eine Zeichenfolge von maximal 4 Zeichen an, die dem symbolischen Namen 
vorangestellt wird. Ohne diese Angabe wird die Zeichenfolge 'YDDF’ jeweils 
dem symbolischen Namen vorangestellt. 


FDBK 
CONT 
CBRC 
Für eine von drei verschiedenen Rückmeldungen können Adressen erzeugt werden: 
FDBK gibt an, daß die Namen für Rückmeldungen nach Beendigung eines Makroauf- 
rufs erzeugt werden sollen (Inhalt des FDBK-Feldes bzw. von Register 15). 
CONT fordert die Erzeugung von Namen an, die auf Inhalte der Register 6 (bei 
LOSCON) bzw. Register 4 (bei COMEND und SECOND) hinweisen. Die Werte 
© werden gefunden, sobald eine Contingency des angegebenen Typs уоп DCAM 


gestartet wurde. 


CBRC fordert die Erzeugung von Namen an, die auf Inhalte des Registers 15 hinweisen. 
Die Werte werden gefunden nach Beendigung eines der folgenden Makroauf- 
rufe: YGENCB; YMODCB; YTESTCB; YSHOWCB. 


Auf den nachfolgenden Seiten werden Auflösungen der drei Varianten des Makroaufrufs 
YDDFDB gezeigt. 
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А7 - 22 


YDDFDB D 


YDDFDB 


ж 


DSECT 


ххжжжжжхжжжжжжж FEEDBACK FIELD 1 ххххххххххххххххххххххлхїлххххлххлхжлжжжж 


YDDFFDB1 
* 
YDDFSUCC 
YDDFSUWA 
YDDFRAPS 
YDDFRPTS 
YDDFRDCS 
YDDFINRU 
YDDFRPAR 
YDDFBCBR 
YDDFSYSX 
* 


ر باد عاد عا عاج ххх эж.»‏ 


YDDFFDB2 


* 
YDDFFD2N 
ж 
ж 
ж 


YDDFNOTO 
YDDFALRO 
YDDFNOSH 
YDDFONEO 
YDDFVERO 
YDDFSECO 
YDDFDIS 

YDDFFCLW 
YDDFFCL 

YDDFFCLD 
YDDFFCEP 
YDDFFCSE 
YDDFFCLT 
YDDFFCLP 
YDDFFCRS 
YDDFTMAR 
YDDFNACT 
YDDFIUPW 
YDDFANUM 
YDDFNPRE 
YDDFIRDF 
YDDFOPSS 
YDDFNPRD 
YDDFCNPA 
YDDFISVR 


* 
ж 
ж 


YDDFNCON 
YDDFACON 
YDDFLOGQ 
YDDFIDID 
YDDFILID 
YDDFCLUR 
YDDFFDIS 
YDDFPCSP 
YDDFPCSS 
YDDFPCST 
YDDFPCA 

YDDFMESL 
YDDFWRCP 
YDDFSQUS 
YDDFNOEX 


DS 


DS 


EQU 


XL1 GENERAL RETURN CODE (IN R15 TOO 
Х'00' REQUEST SUCCESSFULLY 

Х'04' REQUEST COMPLETED WITH WARNING 
Х'08' REQUEST REJ. DUE TO APP. STATE 
A D REQUEST REJ. DUE TO PART. STATE 
X'10' REQUEST REJ. DUE TO DCS STATE 
Х'14' INVALID REQUEST USAGE 

Х'18' REQUEST REJ. DUE TO BAD PARAM 
Х'20' BAD CONTROL BLOCK/PL (REFERENCE 
Х'СС' RESERVED FOR SYSTEM EXITS 
FEEDBACK FIELD 2 xxx xxx xx kk k KK k k k k k k k k k k k k k k kk k kk kkk kkk 
XL1 REASON FOR REJECTION 

A “00” NO INDICATION IN FDBK-FIELD 2 


THE FOLLOWING EQUATES ARE VALID IF RAPS IS SET 
IN FEEDBACK FIELD 1 


Х'04' APPLICATION МОТ OPENED 

X'08' APPLICATION ALREADY OPENED 
Х”ОС” APPLICATION IS МОМ SHARABLE 
X'10/ NO MORE THAN ONE OPEN IS ALLOWE 
Х' 14” WRONG OPEN FOR PRIMARY TASK 
Х'18' WRONG OPEN FOR SECONDARY TASK 
Х'1С' DISTRIBUTION ALREADY PERMITTED 
Х'20' FORCED APPL. CLOSING WARNING 
X'24' FORCED APPL. CLOSING 

Х'28' FORCED CLOSING — DCAM ERROR 
Х'2С' FORCED CLOSING-INV CONT BY PRIM 
X'30' FORCED CLOSING-INV CONT BY SEC 
X'34' FORCED CLOSING — TERM OF PRIMAR 
A A8 FORCED CLOSING BY PRIMARY TASK 
A A FORCED CLOSING BY SECONDARY TAS 
A A0 TOO MANY REQUESTS PENDING 

A A4 APPLICATION NOT ACTIVE 

A A8 INVALID USEPW 

X AL TOO MANY APPL. OPENED 

Х'50' ТОО MANY NON-PREDEFINED APPL. /ТА5 
X'54' INVALID PASSWORD FOR RDF 

X'58' APPL. OPENED BY ANOTHER SUBSYSTE 
X'5C' TOO MANY NON-PREDEF. APPL. 

A 60 TOO MANY CONN./NONPREDEF.APPL. 
Х' 64' INVALID DCAMVER OF SECONDARY 


THE FOLLOWING EQUATES ARE VALID IF RPTS IS SET 
IN FEEDBACK FIELD 1 


Х”04” PARTNER NOT CONNECTED ТО APPL. 
X'08' PARTNER ALREADY CONNECTED 

A D LOGON REQUEST QUEUED 

X'10' INVALID DID 

X'14' INVALID LID 

Х'18' CNNECTION CLOSED BY USER REQUES 
A TU PARTNER FORCED DISCONNECTED 
Х'20' PARTNER IN CS STATE PENDING 
Х”24” CHANGE ТО CA NOT ALLOWED 

Х'28' PARTNER IN CS FOR ANOTHER TASK 
Х'2С' PARTNER IN CA STATE 

A 20 MESSAGE IS TOO LONG 

X'34' WRONG CODE POSITION 

X’ 38” SEQUENCE+ ALREADY USED 

X’ 3C EXPRESS NOT ALLOWED 
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YDDFNUSD 
YDDFIPAR 
YDDFSYTI 
YDDFPNAV 
YDDFPSTP 
YDDFPNLG 
YDDFILPW 
YDDFREJL 
YDDFPCNA 
YDDFISSE 
YDDFPSTR 
YDDFPNVT 
YDDFPDED 
YDDFNDCG 
YDDFIDIS 
* 

YDDFSYER 
YDDFNONA 
YDDFAPCO 
YDDFIPSW 
YDDFRCOS 
YDDFRPRI 
YDDFPPRE 
YDDFRADM 


* 
* 
* 


YDDFSHOR 
YDDFSHUT 
YDDFOSHU 
YDDFIACT 
YDDFDCSE 
YDDFDCLK 


ж 
ж 
ж 
YDDFIRSE 
YDDFIRNS 
YDDFIRNL 
YDDFERPE 
YDDFNAUT 
YDDFSYNQ 


* 
* 
* 


YDDFIACB 
YDDFICCB 
YDDFIDCG 
YDDFIDIP 
YDDFIENB 
YDDFIAAD 


YDDFIDAD · 


YDDFIPAD 
YDDFICOI 
YDDFIEVI 
YDDFIARA 
YDDFIAAR 
YDDFIAPN 
YDDFIDIN 
YDDFIPTN 
YDDFIPRO 
YDDFCCBA 
YDDFSEQH 
YDDFWRLN 
YDDFISUB 
YDDFIPRN 
YDDFNGAR 


X40 
Х'44' 
Х'48' 
A AL 
Х'50' 
Х'54' 
Х'58' 
Х'5С' 
Х'60' 
X 64' 
Х'68' 
X BL 
Х'70' 
Х'74' 
LACH 


A 80” 
X’ 84” 
Х'88' 
Х'8С' 
X90 
Х'94' 
Х'98' 
A HL 


NO USER DATA WITH REJLOG 
INVALID DEPROT/EDIT 

SYSTEM TIMEOUT 

PARTNER NOT AVAILABLE 

PARTNER IN STOP STATE 

PARTNER IN NLOGON STATE 
INVALID LOGPW 

REQUEST REJECTED 

PTNCHAR NOT ACCEPTED BY PTN 
INVALID STAT.SERV.ELMT DATA 
РТМ IN STOP; НЕПСОМ FOLLOWS 
ERR IN ACTIVATING PTN’S VTSU 
PARTNER ALREADY DEDICATED 

NO DCG 

IMMEDIATELY DISCONNECTED 
AFTER ACCEPTANCE 

SYNTAX ERROR IN USER MSG 
UNKNOWN AUTHORIZATION NAME 
APPLICATION ALREADY CONNECTED 
INVALID PASSWORD 

PROPOSED GROS REJECTED BY PTN 
PROP. NETW.PRIO REJ’D BY PTN 
PTN PROCESS ERR (X.25EVENT,..) 
CONN.REQ. REJECTED BY ADMIN. 


THE FOLLOWING EQUATES ARE VALID IF RDCS IS SET 


IN FEEDBACK FIELD 1 


Х'04' 
Х'08' 
Х'0С' 
Х'10' 
Х'14' 
Х'20' 


DCS SHORTAGE OF RESOURCES 
DCS SHUTDOWN WARNED 

DCS QUICK SHUTDOWN 

DCS INACTIVE 

DCS ERROR 

DCAM IS LOCKED 


THE FOLLOWING EQUATES ARE VALID IF INRU IS SET 


IN FEEDBACK FIELD 1 


Х'04' 


INVALID REQUEST FOR SECONDARY 
NOT ALLOWED FOR NONSHARE APPL. 
NOT ALLOWED WITH ATTR. NLOGON 
EQUIVALENT REQUEST PENDING 
APPICATION NOT AUTHORIZED 
SYN REQUEST ALREADY QUEUED 


THE FOLLOWING EQUATES ARE VALID IF RPAR IS SET 


IN FEEDBACK FIELD 1 


Х'04' 
X'08' 
Х'0С' 
Х'10' 
Х'14' 
Х'18' 
Х'1С' 
Х'20' 
Х' 24' 
Х”28” 
Х'2С' 
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INVALID ACB ADDRESS 

INVALID CCB ADDRESS 

INVALID DCG ADDRESS 

INVALID DIP ADDRESS 

INVALID ENB ADDRESS 

INVALID APPNAME ADDRESS 
INVALID DISNAME ADDRESS 
INVALID PTNNAME ADDRESS 
INVALID CONTINGENCY ID. ADDRESS 
INVALID EVENT ITEM ID. ADDRESS 
INVALID AREA ADDRESS 

INVALID AAREA ADDRESS 

INVALID APPLICATION NAME 
INVALID DISTRIBUTION NAME 
INVALID PARTNER NAME 

INVALID PROCESSOR NAME 

CCB REFERRED TO BY ASYNCHR. 
SEQUENCE NUMBER TOO HIGH 
AAREALN LESS THAN 8 / AREALN = 
INVALID SUBFUNCTION 

INVALID PRONAME ADDRESS 
NEGATIVE AREALN 


A7 - 23 


A7 - 24 


YDDFEDER 
YDDFICDL 
YDDFIPCL 
YDDFIPCA 


ж 


د اد хх‏ عار х х х‏ باج عاو کاو کار کار 


YDDFFDB3 


ж . 


* 
* 


YDDFNORM 
YDDFMTRN 
YDDFMKEP 
ж 

YDDFPTSK 
YDDFSTSK 


ж 
ж 
ж 


YDDFCODE 
YDDFNOIN 
YDDFNOLO 
YDDFTOUT 
YDDFLDAT 
YDDFLOCT 
YDDFLMTR 
YDDFEDTE 
YDDFPTTR 
YDDFOUTR 
YDDFEDIV 
YDDFTRES 
YDDFILHC 
YDDFINLC 


* 
* 
ж 
ж 


YDDFTRYL 
YDDFBSHO 
YDDFWTGO 
YDDFNOCB 
YDDFNOID 
YDDFNMEM 
YDDFPTSH 


* 
ж 
ж 
ж 
YDDFEDPE 
YDDFDVHD 
YDDFMSGL 


* 


kkkkkkkkkkkxk*kxxk*kxk 


EQU 
EQU 
EQU 
EQU 


DS 


EQU 
EQU 
EQU 


YDDFFDB4 DS 


ж 
YDDFFDAN 
* 
ж 
ж 


YDDFMSG 
YDDFGO 
YDDFPTCK 
YDDFNTCK 
YDDFEXPD 
YDDFELMT 
YDDFSGRP 
YDDFGRUP 


EQU 


Х'5С' EDITING ERROR 

X'60' INVALID CODELN 

Х' 64' PTNCHLN LESS 4 BYTES 
Х'68' APTNCH INVALID 


FEEDBACK FIELD 3 > xxx xx že de de e xe ve ke He e e e e Fe ж Ж Ж He He He e ke ke ke ke Ke 


XL1 


INDICATORS 


THE FOLLOWING EQUATES ARE VALID IF SUCC IS SET 


IN FEEDBACK FIELD 1 


A 00’ MESSAGE NOT TOO LONG 

Х'04' MESSAGE TRUNCATED 

X'08' REMAINDER OF MESSAGE IS KEPT 
X'00' TASK IS PRIMARY 

X'04' TASK IS SECONDARY 


THE FOLLOWING EQUATES 
SET IN FEEDBACK FIELD 1 


ARE VALID IF SUWA IS 


Х'04' CONTRADICTION IN DATA CODE 
X'08' NO INPUT AVAILABLE 

X OC’ NO LOGON REQUEST QUEUED 

Х'10' REQUEST CANCELED BY TIMEOUT 
Х'14' LOSS OF DATA DUE ТО TIMEOUT 
Х'18' LOGON REQUEST CANCELED - TIMEOU 
Х'20' LOGON MESSAGE TRUNCATED 

Х' 24' EDIT ERROR OCCURRED 

Х'28' PTNCHAR TRUNCATED 

Х'2С' OUTPUT TRUNCATED 

X'30' INVALID EDIT OPTIONS 

X'34' REQUEST TERMINATED BY YRESET 
Х'44' LOCAL HARDCOPY МОТ ASSIGNED 
X'48' NEW LINE CHAR. WHILE EXTEND=Y 


THE FOLLOWING EQUATES ARE VALID IF 
RDCS IS SET IN FEEDBACK FIELD 1 AND 
SHOR IS SET IN FEEDBACK FIELD 


Х'04' BCAM: TRY 1/0 LATER 

LAUCK BCAM: SHORTAGE OF RESOURCES 
Х”ОС” ВСАМ: WAIT FOR GO 

Х'20' ПСАМ: NO CONTROL BLOCK AVAILABL 
Х' 24' ПСАМ: NO ID-ENTRY AVAILABLE 
Х'28' ПСАМ: NO MEMORY AVAILABLE 

Х'2С' DCAM: SH.RES. АТ PTN’S SYSYTEM 


THE FOLLOWING EQUATES ARE VALID IF 
RPAR IS SET IN FEEDBACK FIELD 1 AND 
EDER IS SET IN FEEDBACK FIELD 2 


х'00' EDIT PARAM ERROR 
X'04' INVALID DEVICE HEADER 
X'08' LENGTH OF RECEIVED MESSAGE = 0 


FEEDBACK FIELD 4 ххххххжхжххжжкжжж жк kk 


AL) 


Х'00' 


DATA INDICATORS 


NO INDICATION IN FDBK-FIELD 4 


THE FOLLOWING EQUATES ARE VALID IF SUCC OR SUWA 
ARE SET IN FEEDBACK FIELD 1 


Х'01' MESSAGE 

Х'02' GO-SIGNAL 

Х'04' РОЅІТІМЕ ТАСК 

Х'08' МЕСАТІМЕ ТАСК 

Х'10' EXPRESS DATA 

Х'20' DATA ITEM IS A ELEMENT 
Х'40' LAST ELEMENT OF SUBGROUP 
X'80' LAST ELEMENT OF GROUP 
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YDDFLNF 


* 
ж 


YDDFDB 


ж 
ж 
ж 


YDDFNUSE 
YDDFRC 

YDDFSHWR 
YDDFSHDW 
YDDFFCWR 
YDDFFCLS 


* 

* 

* 

ж 

ж 

YDDFDSUS 
YDDFIPRM 
YDDFPPER 
YDDFPTNA 
YDDFDSSY 
YDDFLOST 
YDDFNETW 
YDDFDSWR 
YDDFRPTC 
YDDFADMS 
YDDFESSE 
YDDFESSP 
YDDFTSER 
YDDFCUME 
YDDFGOSN 
YDDFPRIN 
YDDFDSSH 


* 


YDDFVTSI 
* 
* 
ж 
ж 
ж 
YDDFSOPN 
YDDFSCLS 


YDDFSDIS 
YDDFLNCO 


* 


YDDFDB 


ж 
ж 
ж 


YDDFRC15 


* 


YDDFOK 


* 
* 


YDDFARSM 


* 


YDDFINCB 


* 


EQU x*-YDDFFDB1 LENGTH OF FEEDBACK INFO 


*,YDDFDB 453 840411 55616014 
DSECT 
REASONS FOR COMEND (R4 - RIGHTMOST BYTE) 


DS CL3 UNUSED 
DS CL1 REASON FOR CONTINGENCY 


EQU Х00 SHUTDOWN WARNING 

EQU Х'04' SHUTDOWN 

EQU Х 08” ЕОКСЕП CLOSURE WARNING 
EQU X'0C' FORCED CLOSURE 


REASONS FOR LOSCON (R6 - RIGHTMOST ВҮТЕ) 


EQU X'00' DISCONNECTION BY USER 
EQU Х'04' INVALID DEPROT/EDIT COMBINATION 
EQU Х'08' РТМ PROCESS ERR(X.25EVENT,..) 
EQU Х'ОС' PARTNER NOT AVAILABLE 
EQU Х10 DISCONNECTION BY SYSTEM OPERATO 
ЕШ Х14 PARTNER LOST CONNECTION 
EQU Х'18' DISCONNECTION DUE TO NETWORK 
EQU Х'20' DISCONNECTION WARNING 
ЕШ X'24' PTNCHAR МОТ АССЕРТЕП BY PARTNER 
EQU Х'28' PTN DISCONN. SUMMONED BY ADM. 
EQU ` A ZC ERR IN STAT.SERV. CONN.ELMT. 
EQU Х'34' ERR IN STAT.SERV.PROTOCOL 
EQU Х'З8' ERR IN TRANSPORT SYSTEM 
EQU Х40 STAT.SERV. CONN. USERMESS. ERR 
EQU AT PO GROS МОТ ACCEPTED BY PTN 
EQU X 54 NETW.PRIO NOT ACC’D BY PTN 
EQU X’58’ SHORT RES АТ PTN’S SYSTEM 

(TOO MANY МТАСК”5,...) 
EQU X'5C' PARTNER'S VTSU INACTIVE 


REASONS FOR SECOND (R5 - RIGHTMOST ВҮТЕ) 


EQU Х'00' OPEN BY SECONDARY TASK 
EQU X'04' CLOSE BY SECONDARY TASK 
EQU Х'08' SECONDARY TASK MISSING 
EQU x-YDDFNUSE | LENGTH 

ж, YDDFDB 453 840411 55616014 
DSECT 


RETURNCODE FOR MANIPULATIVE REQUESTS 
(R15 - LEFTMOST BYTE) 


DS CL1 LEFTMOST BYTE OF R15 

EQU Х 00” REQUEST SUCCESSFUL 

EQU Х'04' USER/REQM - AREA TOO SMALL 
(YGENCB) 

EQU Х'04' BLKADDR POINTS TO INVALID CB 


(YMODCB, YSHOWCB, YTESTCB) 
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A7-25 


A7 - 26 


* 
ж 
YDDFMISS 
* 
* 
* 


YDDFNOFW 


ж 


YDDFNOMD 


* 


YDDFUSAR 


* 
YDDFERET 
* 
* 
* 
YDDFIBLK 
* 
ж 
ж 
YDDFIFLD 
* 
* 
YDDFILST 
* 
* 


YDDFIUSA 


* 
YDDFICBA 
* 
* 
YDDFIREF 
* 
* 
ж 


YDDFLNC 


* 
* 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


EQU 


DS 
EQU 


A 08” 


X’ OC’ 
X’ OC’ 
A OC’ 


Х”ОС” 


Х'10' 


Х'14' 


Х'18' 


X'1C' 


X'1C' 


Х'20' 


CL3 
*-YDDFRC15 


ж, YDDFDB 


OBLIGATORY РАНАМ MISSING 
(ҮСЕМСВ, ҮМОПСВ, Ү5НОМСВ, YTESTCB) 


WAREA NOT ON FULLWORD BOUNDARY 
(YGENCB) 

MODIFICATION NOT ALLOWED 
(YMODCB) 

USER AREA TOO SMALL 

(YSHOWCB) 

INVALID ERET ADDRESS 

(YTESTCB) 


INVALID BLK/BLKADDR COMBINATION 
(YMODCB, YSHOWCB, YTESTCB) 


INVALID FIELD/BLK COMBINATION 


INVALID LIST-ADDRESS (MF-PARAM) 


INVALID ADDRESS OF USER AREA 
(YGENCB, YSHOWCB) 

INVALID CB-ADDRESS 

(YMODCB, YTESTCB) 


INVALID CB REFERENCE 
INVALID PL REFERENCE/CONTENTS 


UNUSED 
LENGTH 


840411 55616014 


DCAM М8.0А ОСАМ Makroaufrufe, U987-J-Z75-2 


А.8 Kommandos für die Namen-Zuweisung 


Für die Namen-Zuweisung gibt es zwei Kommandos an das ÖOrganisationsprogramm des 
BS2000. Hier folgt eine kurze Funktionsbeschreibung und die Darstellung des Formats. 


1. APPLICATION-Kommando 


Das APPLICATION-Kommando wird von DCAM-Benutzern verwendet, um in einer prozeßspe- 
zifischen Tabelle, der CLT (communication link table), REES über eine DCAM-Anwendung 
zu speichern bzw. zu löschen. 


Bei Eröffnung der DCAM-Anwendung durch ein DCAM-Benutzerprogramm ersetzen die 
Werte dieser Tabelle die entsprechenden Einträge im Anwendungssteuerblock ACB (Assem- 
bler) bzw. in der Anwendungsstruktur (COBOL). Die Verknüpfung des CLT-Eintrags mit 
diesem Programmbereich wird durch den Kettungsnamen hergestellt, der dazu sowohl im 
Kommando als auch im Programm angegeben werden muß. 


Format 


кы [anwendungsname | 


APPL 


‚LINK=kettungsname 

|, DISNAME=verteilungsname] 
[, USEPASS=kennwort1] 

[, USEPW=kennwort2] 


[, LOGPASS=kennwort3] 


Die Bedeutung der Operanden ist beim Makroaufruf YAPPL beschrieben. 
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2. CONNECTION-Kommando 


Das CONNECTION-Kommando wird von DCAM-Benutzern verwendet, um in einer prozeß- 
spezifischen Tabelle, der CLT (communication link table), Angaben über eine logische 
Verbindung zu speichern bzw. zu löschen. 


Während die Verbindung aufgebaut wird, ergänzen oder ersetzen die Werte dieser Tabelle die 
entsprechenden Angaben im Verbindungssteuerblock CCB (Assembler) bzw. in der Verbin- 
dungsstruktur (COBOL). Die Verknüpfung des CLT-Eintrags mit diesem Programmbereich 
wird durch den Kettungsnamen hergestellt, der dazu sowohl im Kommando als auch im 
Programm angegeben werden muß. 


Format 


pe 


[partnername] 
CONN 


‚LINK=kettungsname 
|, РКОМАМЕ-ргогпате | 
[,USERFLD=benutzerfeld] 


|, LOGPW=kennwort4] 


Die Bedeutung der Operanden ist beim Makroaufruf YCONN beschrieben. 
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А.9 Mnotes 


Beschreibung der Mnotes der DCAM-Makroaufrufe 


MNOTES 


MACRO MNOTE 
alle ММОТЕ х,тасгопате, versionsnummer 


YACB MNOTE O,ATTR INCORRECT 
MNOTE O,ATTR SUBOPERAND CONFLICT 
MNOTE 0,УЕНІҒҮ INCORRECT 
MNOTE О, LINKMOD INCORRECT 
MNOTE 0,106РА55 INCORRECT 
MNOTE 0,USEPASS INCORRECT 
MNOTE 0,USEPW INCORRECT 
MNOTE 0,ПСАМУЕН INCORRECT 


© ҮССВ MNOTE 0,LOGPW INCORRECT 
MNOTE O,USERFLD INCORRECT 
MNOTE 0,ЕПІТІМ INCORRECT 
MNOTE 0,ЕПІТІМ SUBOPERAND CONFLICT 
MNOTE 0,EDITOUT INCORRECT 
ММОТЕ 0,EDITOUT SUBOPERAND CONFLICT 
MNOTE 0,РНОС INCORRECT 
MNOTE О, РКОС SUBOPERAND CONFLICT 
MNOTE О, LINKMOD INCORRECT 
MNOTE 0,DEPROT INCORRECT 
MNOTE 0,EDIT INCORRECT 
MNOTE 0,MAXLN OVERFLOW 


YRPB MNOTE О, ОРТСО INCORRECT 
ММОТЕ 0,TOVAL OUT OF RANGE 
MNOTE 0,EIDREF INCORRECT 
MNOTE 0,0РТСП SUBOPERAND CONFLICT 


bei allen MNOTE 2,REQTYPE INCORRECT 
folgenden | ММОТЕ 1,МҒ INCORRECT. STANDARD FORM ASSUMED 


zusätz- | MNOTE 0 FIELDS-SUBOPERAND INCORRECT 
lich MNOTE 0 FIELDS-SUBOPERAND NOT COMPATIBLE WITH BLK 
© ММОТЕ O.USEPASS INCORRECT 


MNOTE 0,USEPW INCORRECT 

MNOTE 0,106РА55 INCORRECT 

MNOTE 0,АТТН INCORRECT 

MNOTE O,ATTR SUBOPERAND CONFLICT 
MNOTE O,VERIFY INCORRECT 

MNOTE 0,ПСАМУЕН INCORRECT 

MNOTE 0,LOGPW INCORRECT 

ММОТЕ 0,DEPROT INCORRECT 

MNOTE 0,ЕПІТ INCORRECT 

MNOTE 0,ЕПІТІМ INCORRECT 

MNOTE 0,ЕПІТІМ SUBOPERAND CONFLICT 
MNOTE 0,EDITOUT INCORRECT 

MNOTE 0,EDITOUT SUBOPERAND CONFLICT 
MNOTE 0,МАХІМ OVERFLOW 

MNOTE О, РТМТҮРЕ INCORRECT 

MNOTE О, РОЕРАОТ INCORRECT 

ММОТЕ 0,PEDIT INCORRECT 

MNOTE 0,PPROC INCORRECT 

MNOTE 0,PROC INCORRECT 

MNOTE О, PROC SUBOPERAND CONFLICT 
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YAPPL 


YCHANGE 


YCLOSE 


YCLSCON 


YCONN 


YDCG 


YDIP 


YFORBID 


YGENCB 


YINQUIRE 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 


MNOTE 
MNOTE 


MNOTE 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 
MNOTE 


MNOTE 
MNOTE 


MNOTE 


MNOTE 
MNOTE 


MNOTE 


0,SEQNO OUT OF RANGE 

O0, USER INCORRECT 

0,0РТСП INCORRECT 

0, OPTCD SUBOPERAND CONFLICT 

О, EIDREF INCORRECT 

0,TOVAL OUT OF RANGE 

O,USERFLD INCORRECT 

0,GID NOT IN REGISTER NOTATION 


0,МИМВЕН OF CODEVALUE’S EXCEEDS LIMIT (=8) 


0,CODEVAL INCORRECT 


0,МИМВЕН OF DCG’S EXCEEDS LIMIT (=16) 


0,CODEIND INCORRECT 
0,LID NOT IN REGISTER NOTATION 


О, РАОМАМЕ NOT COMPATIBLE WITH BLK-VALUE 


0, LINKMOD INCORRECT 


0, LINKMOD NOT COMPATIBLE WITH BLK-VALUE 
0, LINK NOT COMPATIBLE WITH BLK-VALUE 
0,DID NOT COMPATIBLE WITH BLK-VALUE 


0,DID NOT IN REGISTER NOTATION 
О, FLAG INCORRECT 


О, FLAG NOT COMPATIBLE WITH BLK-VALUE 
0,АІП NOT COMPATIBLE WITH BLK-VALUE 


0,AID NOT IN REGISTER NOTATION 


0,CID NOT COMPATIBLE WITH BLK-VALUE 


0,CID NOT IN REGISTER NOTATION 


О,РАВАМ NOT COMPATIBLE WITH BLK-VALUE 


1,LINK MISSING 
1,LINK INCORRECT 

0, АРРМАМЕ INCORRECT 
0,DISNAME INCORRECT 
0,05ЕРА55 INCORRECT 
0, USEPW INCORRECT 
0,LOGPASS INCORRECT 


1,RPB PARAM MISSING 


1, PARAMETER MISSING 
1,AID NOT IN REGISTER-NOTATION 


1,RPB PARAM MISSING 


1,LINK PARAMETER MISSING 
1, LINK. INCORRECT 
О,РТММАМЕ INCORRECT 
О,РВОМАМЕ INCORRECT 

0, USERFLD INCORRECT 
0,LOGPW INCORRECT 


0,CODEVAL INCORRECT 


О, NUMBER OF CODEVAL’S EXCEEDS LIMIT (=8) 


0,CODEIND INCORRECT 


O, NUMBER OD DCG’S EXCEEDS LIMIT (-16) 


1,RPB PARAM MISSING 


1,BLK PARAM MISSING 


0,CB-IDENTIFIER NOT ALLOWED FOR GIVEN BLK 


1,RPB PARAM MISSING 
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JMODCB 


JOPEN 


JOPNCON 


YPERMIT 


YRECEIVE 


YREJLOG 


YRESET 


YSEND 


YSENDREC 


YSETLOG 


YSHOWCB 


YTESTCB 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 
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1,BLK 
1,ACB 
1,RPB 
1,RPB 
1,RPB 
1,RPB 
1,RPB 
1,RPB 
1,RPB 


1,RPB 


AND/OR BLDADDR MISSING 
MISSING 

PARAM MISSING 

PARAM MISSING 

PARAM MISSING 

PARAM MISSING 

PARAM MISSING 

PARAM MISSING 

PARAM MISSING 


PARAM MISSING 


1,PARAM MISSING 


1,BLK 


AND/OR BLKADDR MISSING 


А9-3 


А.10 Verschlüsselung des Funktionstastencodes 


Verschlüsselung des Funktionstastencodes: 


Code | Bedeutung 8103/ 8161 / ES" 
10/50 62/60 


00 Datenüber- Ü DÜZ/DÜM DÜZ/DÜM 
tragung 
(normal) 
01 Kurztele- FT1 
gramm 1 
02”) 4 2 2 ЕТ2 
03 Р 3 3 DVA 
04 > 4 4 
05 g 5 5 
06 5 6 6 
07 5 7 7 
08 T 8 8 
09 25 9 9 
© ОА ° 10 0 
0B 4 11 1 
0C ” 12 2 
OD ” 13 д 
ОЕ ы; 14 _ _ _ 
20 Datenüber- 0077 / 00М 
tragung DÜB+FZ - 
(markiert)O 
21 ” - 
22 - 
23 - 
24 - 
25 - 
30 Datenüber- Ü өң 
tragung 
(Positions- 
daten) 
40 spezielle Eingabe 
Datenüber- im By- 
tragung pass- 
betrieb 
41 5 positive| positive 
© Rück- Rück- 
meld. meld. 
42 negative| negative 
Rück- Rück- 
meld. meld. 
43 Eingabe- 
feld(8121) 


*) im Teilnehmerbetrieb reserviert für ESCAPE, BREAK 
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е, 
Supa 
Z< 


А.11 Auswirkungen der CCITT-Empfehlung X.25 
auf die IDCAM-Benutzerschnittstelle 


Nach der CCITT-Empfehlung X.25 lassen sich Datenendeinrichtungen an Datenpaket-Vermitt- 
lungsnetze (DPVN) anschließen. In TRANSDATA erfolgen diese Anschlüsse unter Verwen- 
dung des Produktes Х.25РОВТ V2.0 im PDN des Anschlußrechners. Damit kann ein heteroge- 
ner Verbund mit TRANSDATA-Systemen oder Fremdsystemen hergestellt werden. "Hetero- 
gen” heißt, daß oberhalb der X.25-Ebene keine TRANSDATA-Protokolle zwischen dem X.25- 
Anschlußrechner (XAR) und einer Datenendeinrichtung auf der anderen Seite des DPVN (XAR 
oder Fremdsystem) ausgetauscht werden (siehe auch Manual "Anschluß an DPVN (X.25, 
X.29'). 


Einschränkungen für die IDCAM-Schnittstelle 


Wenn beide Kommunikationspartner in eine TRANSDATA-Umgebung eingebettet sind, müs- 
sen X.25-spezifische Funktionen nicht gesteuert werden. 


Anders im Stationsmodus: Hier ist eine DCAM-Anwendung in eine TRANSDATA-Umgebung 
eingebettet, der andere Kommunikationspartner in eine TRANSDATA-fremde Umgebung 
eingebettet. Dadurch ergeben sich einige Einschränkungen für die IDCAM-Schnittstelle: 


IDCAM-Funktion X.25-Funktion Einschränkung 
gegenüber TRANSDATA 


Verbindungs- Aufbau der 
anforderung virtuellen Verbindung 
(YOPNCON ACQUIRE) 


Nur zu Anwendungen 
möglich, die bei 

der PDN-Generierung 
definiert wurden. 


Bestimmte Struktur 
ist vorgeschrieben. 


Verbindungsnachricht 
(AREA im YCCB bzw. 
LOGON-Contingency) 


Steuerung 
der wahlfreien 
Leistungsmerkmale 


Nachrichten- Wird nicht Muß immer 
aufbereitung übermittelt die Anwendung selbst 
(EDIT=USER im YCCB) durchführen 


Wird nicht Nur EBCDI-Code 
übermittelt möglich. 


Nachrichten-Code 
(PROC=SYSCODE 
im YCCB) 


Wird nicht 
übermittelt 


Initiative bei der 
Datenübermittlung 
(PROC=ANYSTART) 


Ist immer beliebig. 


Wird nicht 
übermittelt 


Partner- 
charakteristika 
(PTNCHA1 im YCCB) 


Partner-Anwendung 
erhält immer den 
Eintrag Х”0133”. 


Verbindungsabbau Rücksetzanforderung Die Transportverbin- 
(LOSCON-Contingency) (RESET) bzw. Abbau dung wird abgebaut 


der virtuellen Ver- (Gründe in LOSCON 
Datenübermittlungs- 
funktion: 


bindung genannt). 
Sequenznummer 


der Nachricht 


Wird nicht Nicht möglich. 
(SEQNO im YRPB) 


übermittelt 
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Einschränkung 
gegenüber TRANSDATA 


Nicht möglich. 


IDCAM-Funktion X.25-Funktion 


Nachrichten- Wird nicht 
strukturierung übermittelt 
(OPTCD=ELEMENT, 

SUBGROUP im YRPB) 


Transport-Quittung Wird nicht 
(ОРТСП-ТАСК іт YRPB) übermittelt 


1.Byte der Nachricht | Q-Bit/ Rücksetzpaket 
(AREA/AAREA im YRPB) 


Nur die Übergabe an 
DUE wird quittiert. 


1.Nachrichtenbyte 
dient X.25-Steuer- 
information. 


Nur 1 Byte 
ist relevant. 


Expreßnachricht 
(OPTCD=EXPRESS 
im YRPB) 


Unterbrechungspaket 


O-Bit, D-Bit 


Das Q(ualfier)-Bit erlaubt die Unterscheidung von zwei Datentypen durch die DEE. Die 
D-Bit-Unterstützung ermöglicht eine Ende-zu-Ende-Kontrolle, sagt aber nichts über den 
Transport der Nachricht zur Anwendung aus. Eine DEE setzt im Paketvorspann ein Bit, das 
D-Bit, auf 1, um für dieses Datenpaket eine Quittung anzufordern. Wird das Bit auf 0 gesetzt, 
hat die Quittung nur lokale Bedeutung, d.h., ein Datenpaket wurde fehlerfrei von DPVN 
übernommen. Die Anwendung des D-Bits muß mit der Netzverwaltung vereinbart sein. 


Näheres siehe Manual "'TRANSDATA Anschluß ап ein Datenpaket-Vermittlungsnetz (X.25, 
X.29)'. 


Format der DCAM-Verbindungsnachricht 
AREA 


[Call User Data] 


a ا‎ 


F = X.25-Facilities (wahlweise) mit n Byte Länge (das X.25-Format ist im Datex-P Benut- 
zerhandbuch des Fernmeldetechnischen Zentralamtes beschrieben) 

LF = Länge von F, d.h., X'00”, wenn F nicht vorhanden ist. (LF selbst ist 1 Byte lang) 

Call User Data: Benutzer-Verbindungsnachricht (wahlweise, Länge maximal 16 Bytes) 
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Call User Data 


6. Das erste Byte der Benutzernachricht ist wie folgt ausgezeichnet: 


ХХҮҮ ҮҮҮҮ 
Ү ist nicht festgelegt (Bit 2° bis 2°); derzeit‘. 
хх (Bit 2° und 2”) 


XX = 00 Ein Teil der CUD enthalten die Kennzeichnung eines Protokolls entsprechend 
anderen CCITT-Empfehlungen, z.B., X.29. 


XX = 01 Ein Teil der CUD wird zu Kennzeichnung eines Protokolls nach Festlegung der 
Netzverwaltung benutzt. 


ХХ=10 Ein Teil der CUD wird zur Kennzeichnung eines Protokolls nach den Festlegungen 
internationaler Benutzer-Organisationen verwendet. 


ХХ = 11 Es gibt keine Einschränkungen für die Verwendung der restlichen CUD durch die 
DTE. 


Hinweis: 


Wird eine gewählte virtuelle Verbindung zwischen zwei paketorientierten DTE’s hergestellt, so 
© reagiert das Netz nicht auf die CUD und nimmt auch keinen Einfluß darauf. 
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Beispiel für den Verbindungsaufbau über die X.25-Schnittstelle 
(Heterogener Verbund) 


Aufruf des Verbindungs - Aufforderung Verbindungs - Aufforderung 
Anwendungsprogramms: über X.25: an Anwendungsprogramm 


YOPNCON ACQUIRE Be ын LOGON-Contingency 
“outgoing call” “Incoming call” (wenn definiert) 


VAR#3 (Region 0) Date Р-Ме!г УАВЖ 4 (Region 1) 


DTE- Adresse 


45890008 > 


45890006 


TRANSDATA 
oder 
Fremdsystem 


XAR : X.25-Anschlußrechner mit PDN 


TRANSDATA-Netze 
VAR : Verarbeitungsrechner mit BS2000 


DTE : Data Terminal Equipment (Datenendeinrichtung) 
ANWxx: Anwendungsname 
Hinweis: 


Verbindungen über die X.25-Schnittstelle können auch vordefiniert werden (siehe Manual 
‘Generierung eines Datenkommunikationssystems‘). In diesem Fall kann sich die DCAM- 
Anwendung mit YOPNCON ACQUIRE an die Verbindung anschließen (siehe 3.2.1.5). Hier wird 
dagegen der dynamische Aufbau von Verbindungen über die X.25-Schnittstelle beschrieben. 
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X.25-Stationstabellen in den Anschlußrechnern 


ç ХАВ+1 


Тегпе ferne naher Parallel 
DTE-Adresse | Anwendung Partner Verbindung ? 


45890008 ANWR1 /2/ - 


45890008 ANWR2 - 


ХАВ-ғ2 


Рага11е1 
Verbindung ? 


naher 
Partner 


ferne 
Anwendung 


ferne 
DTE-Adresse 


45890007 ANWL1 /3/ ANWR1 4/1 /13/ 
45890007 ANWL2 (irrelevant) - 
45890006 | АМАМ1 /8/ | АМИН2 4/1 + 
Die Einträge werden 
© bei der Generierung 
des PDN definiert 
durch 
PARTNAM, 
XSTAT-Parameter: DTEADR STATNAM PARTPRO PARVER 


XKON-Parameter: PARTNAM, 


PARTID 


Beispiel 1: Direkter Verbindungsaufbau 


Т Einzelverbindung 


| /4/ 
YOPNCON ACQUIRE РТММАМЕ: АМИН1 /1/--» LOGON-Contingency (wenn definiert) 
PRONAME: XAR#1 YINQUIRE REQLOGON PTNNAME=ANWL1 /5/ 


PRONAME=XAR+2 
YOPNCON ACCEPT 


2. Verbindungsaufforderung an verschiedene nahe Partner einer DTE 


/9/ 
incoming call von DTE 45890006 /6/ --- LOGON-Contingency 
YINQUIRE REQLOGON PTNNAME: ANWM1 


PRONAME: XAR+2 


/10/ 
incoming call von DTE 45890007 /7/ —— LOGON-Contingency 
YINQUIRE REQLOGON РТММАМЕ: ANWL1 
PRONAME: XAR#2 
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3. Parallelverbindungen 


ANWL1 


YOPNCON ACQUIRE РТММАМЕ: ANWR1 —/11/— 
PRONAME: XAR+1 


ANWL2 oder Forts. ANWL1 


YOPNCON ACQUIRE PTNNAME: ANWR2 —/12/— 
PRONAME: ХАНФ1 


Beispiel 2: Verbindungsaufbau mit Prädialog 


/16/+- 


e 


/17/-» 


ANWL2 


LOGON Contingency «-/17/«- 
(wenn definiert) 
YINQUIRE REQLOGON PTNNAME: ANWR1 
PRONAME: XAR+#1 
-»/17/-» 'CN04 


LOGON-Contingency 

YINQUIRE REQLOGON PTNNAME: ANWL1001 
PRONAME: XAR+2 /14/ 

YOPNCON ACCEPT 


LOGON-Contingency 
YINQUIRE REQLOGON PTNNAME: ANWL1002 
PRONAME: XAR#2 /15/ 


YOPNCON ACQUIRE PTNNAME: ANWL2 
PRONAME: XAR#2 

Rückmeldung: Verbindung aufgebaut 
--» СІП 


ҮНЕСЕТУЕ СІП /18/ 
"СМ01 PLEASE ENTER NET COMMAND’ 


YSEND СІП ’OPNCON ANWL2, 3/0’ 
YRECEIVE CID 


CONNECTED WITH ANWL2, 3/0; IND=C’:: ' 


PLEASE START DIALOG’ 


YOPNCON ACCEPT 


T 


A11-6 


YSEND CID /19/ 
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Erklärung zu Beispiel 1 


1. Einzelverbindung 


/1/ 


/2/ 


/3/ 


/4/ 
/5/ 


/3/ 


outgoing call: 


Aufforderung zum Aufbau einer Verbindung über X.25: Als Prozessor der Partner- 
verbindung wird der nahe X.25-Anschlußrechner XAR #1 angegeben. 


In der X.25-Stationstabelle von ХАН #1 verweist der Name des zu verbindenen 
Partners ANWRI als Stellvertreter einer fernen Anwendung auf die zu errei- 
chende ferne DTE-Adresse 45890008. Diese ist die Zieladresse für den outgoing 
call. 


incoming call: 
Der incoming call über X.25 enthält die Ursprungs-DTE-Adresse 45890007. 


Diese identifiziert in der X.25-Stationstabelle des nahen Anschlußrechners 
XAR #2 den (stellvertretenden) Namen ANWLI1 des fernen Partners sowie den 
zuzuordnenden nahen TRANSDATA-Partner ANWRI. 


Die nahe Partner-Anwendung erhält eine Verbindungs-Aufforderung. 


Auskunft über Verbindungs-Aufforderung: Als Prozessor der Partner-Anwendung 
erscheint der nahe Anschlußrechner XAR #2. 


Der Partnername ANWL1 entspringt dem Eintrag іп der X.25-Stationstabelle von 
XAR #2. 


2. Verbindungsaufforderungen an verschiedene nahen Partner einer DTE 


/6/ /7/ 


/8/ /3/ 


/9/ /10/ 


Incoming calls von verschiedenen fernen DTE-Adressen (oder verschiedenen 
private extensions ein und derselben DTE-Adresse). 


Die verschiedenen DTE-Adressen (oder private extensions) identifizieren in der 
X.25-Stationstabelle jeweils eigene Einträge. 


Entsprechend den verschiedenen Einträgen gehen die Verbindungs-Aufforderun- 
gen an verschiedene nahe TRANSDATA-Partner. 
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3. Parallelverbindungen 


/11/ /12/ 


/3/ 


/13/ 


/14/ /15/ 


Mehrere incoming calls von ein und derselben fernen DTE-Adresse 45890007 
(keine private extensions) aufgrund der Verbindungs-Aufforderungen von einer 
oder mehreren fernen Anwendungen. 


Sie führen entsprechend dem ersten Eintrag für die DTE-Adresse 45890007 in der 
X.25-Stationstabelle von XAR #2 jeweils zu Verbindungs-Aufforderungen an ein 


` und denselben nahen TRANSDATA-Partner ANWR1. 


Ist (der Stellvertreter) ANWL1 in XAR #2 mit PARVER = JA generiert, so können 
mehrere parallele Verbindungen zu ANWR1 aufgebaut werden. 


Der Name des auffordernden Partners (aus der X.25-Stationstabelle von 
XAR #2) wird bei parallelen Verbindungen jeweils mit einer 3-stelligen Laufnum- 
mer modifiziert. 


Erklärung zu Beispiel 2 


/16/ /2/ 


/17/ 


/18/ 


/19/ 


Für den incoming call von der fernen DTE-Adresse 45890008 ist іт ХАН #1 kein 
naher Partner vordefiniert. 


Im Prädialog mit der Verbindungssteuerung des fernen X.25-Anschlußrechners 
XAR #1 nennt АММУН1 den gewünschten fernen Partner. 


Der Prädialog läuft als Datenaustausch über die aus DCAM-Sicht bereits aufge- 
baute Verbindung. | 


Der Datenaustausch zwischen ANWL2 und АММУН1 kann beginnen. 
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Verbindungsbehandlung durch den X.25-Port 


çS - Gründe für Ablehnung eines Aufbauwunsches 
Ablehnung durch das X.25-Netz Rückmeldung nach YOPNCON 
(siehe Anhang A.2) 
Gegenstelle belegt/gestört OC AC 
Gegenstelle verweigert Gebührenübernahme 0C5C 
ungültiger Verbindungswunsch 0C4C 
Zugang verhindert (Betriebsmittelengpass) ODC AC 
Netz überlastet (Betriebsmittelengpass) 0С4С 
Gegenstelle nicht erreichbar OCAC A 
Ablehnung durch den X.25-Port Rückmeldung nach YOPNCON 
ç (siehe Anhang A.2) 
Leitung führt nicht zu dem im Adreßbuch ven 
angegebenen Netz (Datex-P, Euronet,...) 
Netz inaktiv OCAC 
generierte DTE-Adresse des Empfängers DC AC 
ist ungültig 
kein freier Supervisor Call (SVC) OCAC 
Name des Empfängers ist nicht im OC AC 


X.25-Adreßbuch 


lokaler Betriebsmittelengpass DC AC 


- Gründe für Verbindungsabbau 


© Grund Wert in Register 6 
bei LOSCON 
Abbau durch ferne DTE X'00' 


Ablauffehler der Gegenstelle/örtlich | Х'08' 


X.25-Reset AT 08” 
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Gründe für negative Transportquittungen 


Dieser Anhang enthält die am meisten vorkommenden, typischen Gründe für negative 
Transportquittungen, die in DCAM-Benutzerprogrammen auftreten können. 


Erzeugen von negativen Transportquittungen 


Negative Transportquittungen können durch Endsysteme oder durch Transit-Systeme erzeugt 
werden. 


Endsysteme sind Systeme, die mindestens einen der Verbindungspartner enthalten. 


Transit-Systeme sind Systeme, die Endsysteme miteinander verbinden. 


Transportsysteme 


Transitsysteme senden negative Transportquittungen, wenn eine Nachricht bzw. Expreßnach- 
richt nicht übermittelt werden konnte, z.B. weil 


e die Leitung oder der Port zum Partnerssytem nicht betriebsbereit ist Hinweis: Ein Grund für 
"Leitung nicht aktiv” kann auch ein Betriebs 
mittelengpaß im Empfangssystem sein. 


e eine Nachricht länger ist als die maximal zulässige Paketlänge. 


Die Behandlung von negativen Transportquittungen ist abhängig von der jeweiligen Produkt- 
version (siehe Tabelle): 


Eigenes System Partnersystem Behandlung von 
DCAM-Version | PDN-Version | negativen Transportquittungen 
< 7.0 irrelevant Alle negativen Transportquit- 
tungen werden an das DCAM-Be- 


nutzerprogramm gesendet. 


>8.0 >8.0 >8.1 Interne Behandlung von negati- 
ven Transportquittungen vom 
Transportsystem durch DCAM. 
Der Typ "Betriebsmittelengpass” 
kommt nicht vor. Er wird durch 
den Datenflußmechanismus er- 
setzt. 
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Endsysteme 


Die Behandlung von negativen Transportquittungen ist unterschiedlich beim PDN und bei 


DCAM/BS2000 (siehe Tabelle): 


Grund 


Datenstation, 
Leitung oder Port 
nicht aktiv 


Anwendung nicht 
verfügbar 


Benutzerprogramm 


Betriebsmittel- 
engpass *) 


Störung im Netz 


DCAM/BS2000 


keine negative Transport- 
quittung, Verbindungsabbau 
nach wiederholtem Versuch 
(Datenstation lokal über 

MSN angeschlossen) 


negative Transportquittung 
(nicht bei vordefinierten 
Verbindungen) 


negative Transportquittung: 
- der: Benutzer übernimmt 

gemeldete Daten nicht 
("Zeitablauf”) 


negative Transportquittung: 
- Stau in der Warteschlange 
für Expreßnachrichten 


PDN 


negative Transport- 
quittung 


negative Transportquittung: 


- Ladefehler beim Anwen- 
dungsprogramm 

- Fehler im Anwendungspro- 
gramm 

- Adressierungsfehler 


negative Transportquittung: 


nur durch das Benutzerpro- 
gramm 


keine negative Transport- 
quittung vom Endsystem 


negative Transportquittung 
X.25-Reset 


*) Das Erzeugen einer negativen Transportquittung hängt von den Produktversionen ab. 


Die aufgeführten negativen Transportquittungen werden an das DCAM-Benutzerprogramm 


gesendet. 
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Logische Steuerzeichen für den Line-Mode (VTCSET) 


Logische Steuerzeichen für Zeilen- und Seitendatenstationen können auch in symbolischer 
Form angegeben werden. Der Makroaufruf VTCSET generiert symbolische Namen, mit denen 
die Steuerzeichen in Line-Mode-Ausgabenachrichten eingefügt bzw. Line-Mode-Eingaben 
aufgefunden werden können. 


Operation Operanden 
VTCSET prefix 
prefix gibt die Zeichenfolge an, die den symbolischen Namen vorangestellt wird. Sie 


darf bis zu 5 Zeichen lang sein. 


In den Beispielen wird anstelle der Zeichenfolge, die den symbolischen Namen vorangestellt 
wird, &P. als Präfix gesetzt. 


1. Logisches Satzsteuerzeichen 
&P.NL Logisches Zeilenende 
Wirkung bei der Ausgabe: 


— Besondere Anzeigeformen an der Datenstation werden auf den Normalzu- 
stand zurückgesetzt (normal, 1. Zeichenvorrat, ungeschützt). 


— Das definierte logische Zeilenendezeichen 
(Kommando /TCHNG LINEND=) wird ausgegeben. 


— Falls die Fortsetzung der Ausgabe einen Datenüberlauf an der Datensta- 
tion verursachen würde, wird die definierte Überlaufkontrolle ausgeführt. 


— Die Schreibmarke wird an den Anfang der nächsten Zeile gesetzt. 


— Bei feldoriertierter Anzeige und strukturierter Ausgabe (HOM=NO) wird 
ein Ausgabefeld eingerichtet. 


“ВР.МР Logisches Seitenende 
Wirkung bei der Ausgabe: 


— Besondere Anzeigeformen auf der Datenstation werden auf den Normal- 
zustand zurückgesetzt (normal, 1. Zeichenvorrat, ungeschützt). 


— Das definierte logische Zeilenendezeichen 
(Kommando TCHNG LINEND =) wird ausgegeben. 


— Der Hardcopy-Druck wird ausgelöst (bei HCOPY = YES). 
— Die definierte Überlaufkontrollaktion wird ausgeführt. 


— Eine neue Seite wird eingerichtet (bei Sichtstationen der Bildschirm 
gelöscht, bei Schreibstationen ein Papiervorschub ausgelöst). 


— Die Schreibmarke wird an den Zeilenanfang gesetzt. 


— Beifeldorientierter Anzeige wird ein Ausgabefeld eingerichtet. 
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&P.CL 


Logisches Satzende (nur bei Schreibstationen und Option (ONOPOSN = YES) 
Wirkung bei der Ausgabe: 


— Besondere Anzeigeformen an der Datenstation werden auf den Normalzu- 
stand zurückgesetzt (Normal, 1. Zeichenvorrat, ungeschützt). 


— Das definierte logische Zeilenendezeichen (Kommando TCHNG 
LINEND=) wird ausgegeben. 


- Die Schreibmarke wird an den Anfang der aktuellen Zeile gesetzt. 


&P.VPA ddd 


Vertikale Position 
Wirkung bei der Ausgabe: 


Der Ausgabetext beginnt in der durch ddd bezeichneten Zeile. 


* &P.HPA ddd 


&P.ASF а 


&P.CAP 


Horizontale Position 
Wirkung bei der Ausgabe: 


In der aktuellen Zeile werden die nachfolgenden Zeichen ab der durch ddd 
bezeichneten Spalte ausgegeben. 


Steuerung Blatteinzug bzw. -auswurf 
Wirkung bei der Ausgabe: 
- Рога =0 ат Nachrichtenende wird ein Blattauswurf bewirkt. 


— Fürd=1,2,3 wird der Blattauswurf mit einem Blatteinzug aus dem durch d 
bezeichneten Einzugsbehälter kombiniert. 


Continue Actual Position 
Wirkung bei der Ausgabe: 


Keine Positionierung auf den nächsten Zeilenanfang bei Nachrichtenbeginn; 
Beginn der Druckausgabe an der augenblicklichen Position des Druckwagens. 


2. Logische Anzeigesteuerzeichen 


&Р.ЕМ1 


&Р.ЕМ2 


&Р.ЕМЗ 


&Р.ЕМ4 


Hervorgehobene Anzeige 1 (Emphasized Layout 1) 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden hervorgehoben (blinkend, kursiv) an 
der Datenstation abgebildet. Die logischen Satzsteuerzeichen und das Steuer- 
zeichen &P.Nor setzen die hervorgehobene Anzeige zurück. 


Hervorgehobene Anzeige 2 (Emphasized Layout 2) 
Wirkung bei der Ausgabe: 

wie hervorgehobene Anzeige 1. 

Hervorgehobene Anzeige 3 (Emphasized Layout 3) 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden hervorgehoben (hell) an der Daten- 
station abgebildet. Rücksetzen wie hervorgehobene Anzeige 1. 


Hervorgehobene Anzeige 4 (Emphasized Layout 4) 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden hervorgehoben (hell, kursiv) an der 
Datenstation abgebildet. Rücksetzen wie hervorgehobene Anzeige 1. 
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&P.NOR 


&P.SO 


&P.SI 


&P.SPA 


&P.EPA 


Normale Anzeige (Normal Layout) 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden in normaler Darstellung an der Daten- 
station abgebildet (Rücksetzen der hervorgehobenen Anzeige). 


Hinweis: 


Die physischen Steuerzeichen zur Anzeigensteuerung belegen einen Zeichen- 
platz am Bildschirm der Datenstation 815x. 


Umschalten in den 2. Zeichenvorrat 


Wirkung bei der Ausgabe (nur bei Datenstationen mit 2. Zeichen vorrat oder 
APL-Zusatz): 


Die nachfolgenden Textzeichen werden im 2. Zeichenvorrat abgebildet. 
Bedeutung bei der Eingabe: 


Die nachfolgenden Textzeichen wurden im (datenstationsspezifischen) 2. 
Zeichenvorrat eingegeben. 


Umschalten in den 1. Zeichenvorrat 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden im 1. Zeichenvorrat an der Datensta- 
tion abgebildet (Rücksetzen aus dem 2. Zeichenvorrat). 


Bedeutung bei der Eingabe: 

Die nachfolgenden Textzeichen sind aus dem 1. Zeichenvorrat. 
Beginn geschützter Bereich (Start Protected Area) 

Wirkung bei der Ausgabe (nur bei Datensichtstationen): 


Die nachfolgenden Textzeichen werden am Bildschirm der Datenstation 
“geschützt” ausgegeben, d.h., sie können nicht überschrieben und zur DVA 
zurückübertragen werden. 


Hinweis: 


Diese Funktion verändert stark die Anzeigeeigenschaft an einigen Datensta- 
tionen (Zeilenwechsel bei der DSS 8152, Hardcopyfunktion bei den Datensta- 
tionen 816x). Sie erfordert daher größte Vorsicht bei der Anwendung. 


Ende geschützter Bereich (End Protected Area) 
Wirkung bei der Ausgabe: 


Die nachfolgenden Textzeichen werden ungeschützt an die Datenstation 
ausgegeben. 
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Daten- Sa an Datenstationen bei Er wë SCH 


8103 

8110 

ТТҮ 

8150 geschützt |unge- 
8153 halbhell [schützt 
5 2223 Be 

8152 kursiv kursiv ы EN APL-ZV 1.ZV 


schützt 
hell 


8160 unge- 
8161 schützt 
9750 halbhell unge- 
9751 BA2: hell schützt 
unterstr. 
ruhig 
8162 unge- 


schützt 


8121 kursiv j|kursiv |kursiv |kursiv [gerade 
8122 
9003 kursiv kursiv kursiv ` gerade, 
rot schwarz 
9752 gelb weiß grün rot gelb 
blinkend |ruhig ruhig ruhig ruhig 
9004 Schatten-|unter- Fett- unterstr. 
druck strichen |druck fett 
9001 unter- unter- unter- unter- 
strichen |strichen |strichen |strichen 
9002 kursiv unter- kursiv kursiv 
strichen unterstr. 


TTY: PT80, T100, T1000; BA: Betriebsart; ZV:Zeichenvorrat 


Tabelle 3-1 Wirkung der logischen Anzeigesteuerzeichen 
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&Р.ОАВ Dunkle Anzeige 
© Wirkung bei der Ausgabe: | 
Die nachfolgenden Textzeichen werden “nicht lesbar” dargestellt. 
&P.PLD Zeile tiefgestellt 
Wirkung bei der Ausgabe: 


Der Drucker wird um eine halbe Zeile vorgerückt, der nachfolgende Text eine 
halbe Zeile tiefer gedruckt. Rücksetzen durch PLU oder am logischen Zeilen- 
ende. 


&P.PLU Zeile hochgestellt 
Wirkung bei der Ausgabe: 


Der Drucker wird eine halbe Zeile zurückgesetzt, der nachfolgende Text eine 
halbe Zeile höher gedruckt. Rücksetzen durch PLD oder am logischen Zeilen- 
ende. 


&P.NUM Ungeschützter numerischer Bereich 
Wirkung bei der Ausgabe: 


© Anfang eines numerischen Bereichs, der hell dargestellt wird und ungeschützt 
ist. 


Bedeutung bei der Eingabe: 


In diesem Bereich können vom Terminalbediener nur numerische Daten 
eingegeben werden. 


&P.VMI d 
Zeilenabstand 
Wirkung bei der Ausgabe: 
Legt den Abstand der Zeilen voneinander fest: 
_ Für d=1 normaler Abstand (1/6 Zoll). 
_ Für d=2 enger Abstand (1/8 Zoll). 

Für d=3 enger Abstand (1/12 Zoll). 

Wirkt bis zum Nachrichtenende. Die Anzahl der Zeilen pro Seite wird dem 
neuen Zeilenabstand angepaßt. 

&P.HMI d 

© Zeichenabstand 


Wirkung bei der Ausgabe: 
Legt den Abstand der Zeichen voneinander fest: 


Für d=1 normaler Zeichenabstand (1/10 Zoll). 
Für d=2 Schmalschrift A (Zeichenabstand 1/12 - 1/15 Zoll). 
Für d=3 Schmalschrift B (Zeichenabstand 1/15 - 1/16,5 Zoll). 


Wirkt, falls vom Benutzer nicht anders angegeben, bis zum Nachrichtenende. 
Die Anzahl der Zeichen pro Zeile wird automatisch angepaßt. 


DCAM V8.0A DCAM Makroaufrufe, U987-J-275-2 А13-5 


А13-6 


&P.LM ааа 


&P.PTS 


&Р.РТХ 


Linker Rand 
Wirkung bei der Ausgabe: 


Setzt einen linken Rand. Das erste Zeichen aller nachfolgenden Zeilen wird in 
der durch ddd angegebenen Spalte gedruckt. 


LM ist nur zulässig am Nachrichtenbeginn, wenn dort kein CAP steht oder 
nach dem ersten abdruckbaren Zeichen nach NL, NP, ASF oder VPA und bleibt 
bis zum Nachrichtenende erhalten, falls keine neue Festsetzung erfolgt. 


Proportionalschrift ein 

Wirkung bei der Ausgabe: 

Durch eine individuelle Zeichenbreite wird ein schöneres Schriftbild erzeugt. 
PTS wirkt bis zum Nachrichtenende oder PTX. 


Die Spaltenzählung wird ausgesetzt und erst durch ein auf PTX folgendes NL, 
NP, ASF, VPA oder HPA wieder eingesetzt. 


Proportionalschrift aus. 
Wirkung bei der Ausgae: 


Schaltet die Proportionalschrift aus. 


&P.MLL ddd 


Maximale Zeilenlänge. 
Wirkung bei der Ausgabe: 


Durch ddd wird die maximale Anzahl der Zeichen pro Zeile neu definiert. Gilt 
für die gesamte Verbindung und nur für Drucker. 


&P.MLN ddd 


Maximale Zeilenanzahl: 
Wirkung bei der Ausgabe: 


Durch ddd wird die maximale Anzahl der Zeilen pro Seite neu definiert. Gilt für 
die gesamte Verbindung und nur für Drucker. 


Weitere logische Steuerzeichen: 


&P.DEL 


&P.BS 


Löschzeichen (Delete) 
Wirkung bei der Ausgabe: 


Das Zeichen wird aus dem Ausgabetext entfernt und nicht an die Datensta- 
tion weitergeleitet. 


Rückwärtsschritt (Backspace; nur bei DSS mit APL-Zusatz): 
Wirkung bei der Ausgabe: 


Das nachfolgende Textzeichen wird über dem vorangegangenen abgebildet 
(Zusammensetzen eines nicht im Zeichenvorrat enthaltenen Zeichens). 


Bedeutung bei der Eingabe: 


Das nachfolgende und das vorangegangene Textzeichen sollen als eine 
Einheit angesehen werden. 
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&P.SUB 


&P.ESC 


&P.DCA 


&P.HT 


&P.VT 


Ersatzzeichen (Substitute) 
Wirkung bei der Ausgabe: 


Dieses logische und sämtliche anderen EBCDIC-Steuerzeichen (Code < 
Х'40') werden mit dem gültigen Ersatzzeichen (Makro TCHNG SUB=OUTIN) 
an der Datenstation abgebildet. 


Wirkung bei der Eingabe: 


Das gültige Ersatzzeichen wurde in der Datenstationseingabe erkannt und 
ersetzt (nur wenn durch Makro TCHNG SUB=OUTIN gefordert; siehe 
Manual "В52000 TIAM’). 


Escape 
Wirkung bei der Ausgabe: 


Setzt das Steuerzeichen ESC ab (EBCDI-Code Х'27'). Dieses Steuerzeichen 
wird zusammen mit dem folgenden Zeichen unverändert übertragen. Man 
kann dadurch Gerätefunktionen der Datenstation im LINE-Mode nutzen, die 
logisch nicht unterstützt werden (siehe hierzu Beschreibungen der entspre- 
chenden Datenstationen). 


wird wie ESC von VTSU-B behandelt 
Wirkung bei der Ausgabe: 


Setzt das Steuerzeichen DC4 ab (EBCDI-Code X’3C’). Dieses Steuerzeichen 
wird zusammen mit den folgenden Zeichen an die Datenstation übertragen. 
Man kann dadurch Gerätefunktionen der Datenstation im LINE-Mode nutzen, 
die logisch nicht unterstützt werden (siehe hierzu Beschreibungen der ent- 
sprechenden Datenstationen). 


Horizontale Tabulierung 
Wirkung bei der Ausgabe: 


Setzt das Steuerzeichen HT ab (EBCDI-CODE X’05’), welches unverändert ап 
die Datenstation weitergereicht wird (siehe hierzu Beschreibungen der ent- 
sprechenden Datenstationen). 


Bei Datensichtstationen ist das Steuerzeichen HT bislang ohne Bedeutung 
und wird von diesen ignoriert. 


Vertikale Tabulierung 
Wirkung bei der Ausgabe: 


Setzt das Steuerzeichen VT ab (EBCDI-Code Х'ОВ’), welches unverändert ап 
die Datenstation weitergereicht wird (siehe hierzu Beschreibungen der ent- 
sprechenden Datenstationen). | 


Bei Datensichtstationen ist das Steuerzeichen VT bislang ohne Bedeutung 
und wird von diesen ignoriert. 
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Anwendbarkeit der neuen logischen Steuerzeichen bei den einzelnen Druckern 


Typ IPLDILM |PTS|VPA MLL | MLN HT 
PLU PTX 


EENS Ad А x. 


X + Funktion wird ausgelöst 
—— das logische Steuerzeichen wird unterdrückt 


Zeichen- und Zeilenabstand bei den einzelnen Druckern in Zoll 


әле [и [шиа KIKI 
жи [зле [тле [e.s тв [мв [зл 
эке [зле [тле [ль [е [м [зле 
e ле [зле [зле [ч e |е 
ээс Гэв | эв (эв (эв: |е 
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Beispiel 


SOURCE STATEMENT 


د „м‏ د a‏ دند мл мл‏ ن ыл ым ым‏ نف ن ن ن ن ن ن zb a‏ ف — 


BVTCSET START 
VTCSET LOG 


* 


+ 


LOGEM1 
LOGEM2 
LOGNOR 
* 
10650 
10651 
* 
LOGSPA 
LOGEPA 


* 

* 

* 
LOGDEL 
LOGBS 
LOGSUB 


IDLKG 
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VIRTUAL TERMINAL CONTROL CHARACTER SET 
ALIGN=C 


LOGICAL RECORD DELIMITERS 


Х'15' LOGICAL LINE END (CONT NEXT LINE) 
Х”ОС” LOGICAL PAGE END (CONT NEXT PAGE) 
X’0D’ LOGICAL LINE END (CONT SAME LINE) 


LOGICAL UNIT DELIMITERS 


A ID EMPHASIZED LAYOUT 1 

Х'1Е' EMPHASIZED LAYOUT 2 

Ж ТЕ: NORMAL LAYOUT 

Х'ОЕ' SHIFT OUT TO 2ND CHARACTER SET 
Х'ОЕ' SHIFT IN TO NORMAL CHARACTER SET 
X36 START PROTECTED AREA 

Х”08” END PROTECTED AREA 


SPECIAL FUNCTIONS 


Х'07' DELETE 
Х'16' BACKSPACE 
A AE SUBSTITUTE 
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А.14 


Beschreibung DCAM System Exit 


Einleitung 


Der DCAM System Exit bietet dem Anwender die Möglichkeit, DCAM-Funktionen zu erwei- 
tern, zu ändern und eigene spezielle Funktionen hinzuzufügen. Solche Funktionen sind 
beispielsweise 


e über TRANSDATA hinausgehender Datenschutz durch erweiterte Berechtigungsprüfun- 
gen 
(z.B.: abhängig von der USERID das Öffenen von Anwendungen zulassen oder für eine 
Anwendung einen Verbindungsaufbau nur mit speziellen Partnern oder Prozessoren 
erlauben) 


e zusätzliche Aktionen veranlassen 
(ЈОВ'ѕ starten, Meldungen ausgeben). 


Die benutzerspezifische Exit-Routine wird beim Öffnen und Schließen von Anwendungen 
sowie beim Öffnen und Schließen von Verbindungen aufgerufen. Beim Öffnen von Anwen- 
dungen und Verbindungen kann die Exit-Routine den Aufruf annehmen, ablehnen oder ggfs. 
modifizieren. Die Aufrufe beim Schließen dienen nur zur Information der Exit-Routine. 


DCAM-Exit-Ereignisse 


Der DCAM-Exit wird bei den im folgenden erläuterten Ereignissen aufgerufen. Jedes Ereignis 
wird eindeutig gekennzeichnet durch den Hauptereignis-Namen und den Unterereignis- 
Namen. 


Hauptereignis-Namen 


APP Ereignis bezogen auf die Existenz von Anwendungen 
"СОМ! Ereignis bezogen auf die Existenz von Verbindungen 
Unterereignis-Namen definiert die einzelnen Ereignisse 


(Öffnen, Schließen, ...) 


Das Exit-Hauptereignis "APP" wird bei jedem Öffnen (Primär oder Sekundär) einer Anwendung 
und bei jedem Schließen (explizit durch YCLOSE oder implizit bei Programmende, Shutdown) 
aufgerufen. 


Das Exit-Hauptereignis “СОМ” wird beim Verbindungsaufbau/Verbindungsabbau in folgenden 
Fällen aufgerufen: 


- Auffordern zum Verbindungsaufbau (YOPNCON ACQUIRE): 
1. Beim YOPNCON ACQUIRE Aufruf des Benutzers 
2. nach erfolgreichem Verbindungsaufbau 
— Annehmen einer Verbindungsaufforderung 
1. Beim Eintreffen einer Aufforderung zum Verbindungsaufbau 
2. nach Annahme der Aufforderung (YOPNCON ACCEPT) 


— beim expliziten Verbindungsabbau durch den Benutzer oder Partner oder nach einem 
DCAM-Fehler. 
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Das Exit-Hauptereignis 'СОМ' wird nicht beim impliziten Schließen aller noch bestehenden 
Verbindungen beim Schließen einer Anwendung aufgerufen. 


1) 


2) 


3) 


4) 


5) 


Exit-Ereignis "APPOPN’ 
Aufruf der Exit-Routine: 


— bei jedem YOPEN-Aufruf, nach Prüfung der Benutzerangaben und vor der Bearbei- 
tung des Aufrufs. 


Funktionen der Exit-Routine: 
— zusätzliche Prüfungen 


(z.B. - Anwendung darf nur von bestimmten USERID'’s eröffnet werden 
— Tabellen zur Exit-Routine nachladen) 


— Аппеһтеп des YOPEN-Aufrufs 

— Ablehnen des YOPEN-Aufrufs 

— Modifizieren bestimmter YOPEN-Parameter 
— zusätzliche Aktionen veranlassen 


(z.B. - JOB's starten (ENTER) 
— Meldungen ausgeben) 


EXIT-Ereignis ’APPCLS’ 
Aufruf der Exit-Routine: 
— bei jedem YCLOSE-Aufruf, vor Abbau der DCAM-Datenstruktur 


Funktionen der Exit-Routine: 


— zusätzliche Aktionen veranlassen 


(8. - Meldung ausgeben 
— Update von Exit-spezifischen Tabellen) 


Exit-Ereignis "APPSHU’ 
Aufruf der Exit-Routine: 


— bei jedem internen Schließen einer Anwendung nach Eingabe eines '"BCLOSE’, 
"BCEND’ oder ‘SHUTDOWN’ Kommandos durch den Operator. 


Hinweis: 
— Der Exit wird nur beim Schließen einer Anwendung, nicht bei einer eventuellen 
vorangehenden Warnung aufgerufen. 


— Der Exit ’APPSHU’ wird nicht aufgerufen, wenn vor der DCAM-Beendigung die 
TIAM-Beendigugn abläuft, d.h., wenn das DCAM-Programm als Dialogprozeß 
gestartet wurde. In diesem Fall wird bereits durch TIAM eine Prozeßbeendi- 
gung eingeleitet; der Exit wird гай ’APPTRM'’ aufgerufen. 


Exit-Ereignis 'APPTRM' 

Aufruf der Exit-Routine: 

— beim internen Schließen einer Anwendung bei Programm- oder Taskterminierung 
Funktionen der Exit-Routine: 

— Neustart einer Ersatztask 

Exit-Ereignis 'APPFCL' 

Aufruf der Exit-Routine: 


— bei erzwungenem Schließen der Anwendung wegen eines DCAM-Fehlers 
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6) Exit-Ereignis СОМАСО” 
ç Aufruf der Exit-Routine: 


— beim Senden einer Aufforderung zum Verbindungsaufbau (YOPNCON ACQUIRE) 
nach Prüfung der Benutzerangaben, vor Ausführung des Aufrufs (d.h. vor Ausgabe 
der REOCON-Nachricht durch das System). 


Funktionen der Exit-Routine: 


— zusätzliche Prüfungen 
(z.B. Verbindungsnachricht (LOGON Message) gemäß Vereinbarungen?) 
— Апппеһтеп des Aufrufs 
— Ablehnen des Aufrufs 
— Modifizieren bestimmter YOPNCON-Paramter 


7)  Exit-Ereignis 'CONACC' 
Aufruf der Exit-Routine: 


— bei jedem Annehmen eines Verbindungswunsches (YOPNCON ACCEPT), nach 
Prüfung der Benutzerangaben, vor Bearbeitung des Aufrufs. 


Funktionen der Exit-Routine: 


© — zusätzliche Prüfungen 
— Аппеһтеп des Aufrufs 
— Ablehnen des Aufrufs 
— Modifizieren bestimmter YOPNCON-Parameter 


8) _ Exit-Ereignis 'CONCPL’ 
Aufruf der Exit-Routine: 


— nach erfolgreichem Verbindungsaufbau, d.h. wenn ein YOPNCON ACQUIRE vom 
Partner angenommen wurde. 


9) Exit-Ereignis “СОМВЕО” 
Aufruf der Exit-Routine: 


— beim Eintreffen eines Verbindungswunsches, nach Prüfung der Angaben, vor 
Bearbeitung des Verbindungswunsches. 


Funktionen der Exit-Routine: 


— zusätzliche Prüfungen 
— Annehmen des Verbindungswunsches 
© — Ablehnen des Verbindungswunsches 


10) Exit-Ereignis 'CONCLS’ 
Aufruf der Exit-Routine: 


— bei jedem Verbindungsabbau durch den Benutzer (YCLSCON), vor Freigabe der 
DCAM-Datenstruktur. 


11) Exit-Ereignis 'CONFCL’ 
Aufruf der Exit-Routine: 


— bei jedem erzwungenen Verbindungsabbau wegen NEABI-Protokollfehler oder 
wegen Quittungs-Überlauf. 


12) Exit-Ereignis 'CONBAD’ 
Aufruf der Exit-Routine: 


— bei jedem Verbindungsabbau, der durch den Partner veranlaßt wurde. 
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А.14.1 System Exits Bedienung 


Mit дет Administrationsprogramm ’EXLOAD’ kann der Systemverwalter die DCAM-Exit- 
Routinen 


— laden 


aktivieren 


deaktivieren 


— sich über den Status der Exit-Routinen informieren. н 
Die Nummer des DCAM- Exits ist '075°. | 


Die Anwendung und Bedienung des Progra E ist im Manual :852000 SYSTEM EXITS’ 
beschrieben. 
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А.14.2 System Exits Programmschnittstelle 


Dieses Kapitel enthält im ersten Abschnitt die allgemeine (d.h. für alle Exit-Ereignisse gültige) 
Beschreibung der DCAM-Exit-Programmschnittstelle. 


Im zweiten Abschnitt wird dann für jedes Exit-Ereignis beschrieben, welche Felder in der 
Parameterliste versorgt sind und wie die Rückgabefelder versorgt werden müssen bzw. 
können. 


Im dritten Abschnitt werden die Einschränkungen beschrieben, die bei der Programmierung 
einer DCAM-EXIT-Routine beachtet werden müssen. 


Der 4. Teil beschreibt die Formate der Makroaufrufe, mit denen die DSECT’s der DCAM- 
Datenstruktur erzeugt werden können. 
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А.14.2.1 DCAM Exit Programmschnittstelle 


A.14.2.1.1 Registerversorgung 


Beim Ansprung der Exit-Routine sind die Register 4-11 undefiniert, die übrigen Register 
enthalten folgende Werte 


"075" Nummer des ОСАМ-Ехіїѕ 


RR = 

R1 = A(YDDEXPL) DCAM-Exit-Parameterliste 
А2 = A(Task Control Block) 

R3 = A (Executive Vector Table) 

R12 = А (Р2 Program Manager) 

R13 = A(18-Wort Registersicherungsbereich) 
R14 = A (indirekter Rücksprung) 

R15 = A(Exit-Routine) 


Die Register 12, 13, 14 dürfen von der Exit-Routine nicht zerstört werden. 
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A.14.2.1.2 


DCAM-Exit-Parameterliste 


Mit dem Makro YDDEXPL kann eine DSECT für die DCAM-Exit-Parameterliste erstellt 
werden. 


Format: 
Name Operanden 
[symbol] | YDDEXPL D 
prefix 
Be 
YDDX 
Operanden 
symbol symbolische Adresse für den Makroaufruf. Wird keine Adresse angegeben, 
so wird die Adresse YDDEXPL abgesetzt. 
D es wird ein Pseudoabschnitt (DSECT) generiert 
prefix gibt eine Zeichenfolge von max. 4 Zeichen an, die den Namen vorausgestellt 
а габр 
Beispiel: 


YDDEXPL DSECT 


KC kk kkk хїї k c k k k k K k K k Sk k Sk Sk KH SK k S K SK Sk Ккк SK K ХХ K S SK K K S K S ХХ AH S HH k S k S K A HH A A e ke Se a $e 


* * 
* DCAM EXIT PARAMETERLISTE * 
* ж 


kk = < T T k k k k k Kk k HH k K k KHK KHK K KHK K SK SK KHK HH KHK HH SK SK SK HH SK K S YK HH S k Sk Sk SK k HH HH A S S A a Sc a SK 
ж 


ж EINGABEPARAMETER 


ж 


YDDXDPAR DS A A(DARPPAR) 

* | DCAM INTERNER ARBEITSBEREICH 
YDDXMAIN DS X EXIT-MAIN-CASE 
YDDXAPPL EQU 1 APPL 
YDDXCONN EQU 2 CONN 

YDDXSUB DS X EXIT-SUB-CASE 
YDDXAOPN EQU 1 APPOPN 
YDDXACLS EQU 2 APPCLS 
YDDXASHU EQU 3 APPSHU 
YDDXATRM EQU 4 APPTRM 
YDDXAFCL EQU 5 APPFCL 
YDDXCACQ EQU 6 СОМАСО 
YDDXCACC EQU 7 CONACC 
YDDXCCPL EQU 8 CONCPL 
YDDXCREQ EQU 9 CONREQ 
YDDXCCLS EQU 10 CONCLS 
YDDXCFCL EQU 11 CONFCL 
YDDXCBAD EQU 12 CONBAD 


ж 


ж EINGABE-/RUECKGABEPARAMETER 


ж 


YDDXLOGL DS H 
YDDXLOGM DS (180 


ж 


ж RUECKGABEPARAMETER 

ж 

YDDXPW DS XL4 

YDDXL EQU х-ҮППЕХРІ 
ж, YDDEXPL 
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LAENGE DER LOGON MESSAGE 
LOGON MESSAGE 


PASSWORT 
LAENGE DER DCAM EXIT PARAMETERLISTE 


450 
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Beschreibung der Felder їп der Parameterliste YDDEXPL: 


YDDXPAR 


YDDXMAIN 


YDDXSUB 


YDDXLOGL 


YDDXLOGM 


YDDXPW 


A (DARPPAR) 

Adresse eines DCAM-internen Arbeitsbereichs. In diesem Arbeitsbereich 
werden weitere aufrufspezifischen Informationen an die Exit-Routine über- 
geben. 


Exit-Hauptereignis (Main-Case) Indikator für die Exit-Routine YDDXAPPL: 
Ereignis bezogen auf die Existenz von Anwendungen. YDDXCONN: Ereignis 
bezogen auf die Existenz von Verbindungen. 


Exit-Unterereignis (Sub-Case) Indikator für die Exit-Routine YDDXAOPN: 
Exit-Case APPOPN YDDXACLS: Exit-Case APPCLS YDDXASHU: Exit-Case 
APPSHU YDDXATRM: Exit-Case APPTRM YDDXAFCL: Exit-Case APPFCL 
YDDXCACO: Exit-Case СОМАСО YDDXCACC: Exit-Case СОМАСС 
YDDXCCPL: Exit-Ccase CONCPL YDDXCREO: Ехї-Сазе CONREQ 
YDDXCCLS: Ехії-Саѕе CONCLS YDDXCFCL: Exit-Case CONFCL YDDXC- 
BAD: Exit-Case CONBAD 


Länge der LOGON-Message 

In diesem Feld wird die Länge der Verbindungsnachricht im Feld YDDX- 
[ОСМ angegeben (<= 80 byte). YDDXLOGL = 0 bedeutet: es ist keine 
Verbindungsnachricht angegeben. Dieses Feld kann von der Exit-Routine 
verändert werden. 


LOGON-Message 
In diesem Feld kann die Exit-Routine beim Rücksprung eine Verbindungs- 
nachricht (LOGON MESSAGE) übergeben. Diese Verbindungsnachricht 
ersetzt die vom Benutzer im Feld AREA angegebene Verbindungsnachricht 
beim YOPNCON. 


Paßwort 
In diesem Feld kann die Exit-Routine beim Rücksprung ein Paßwort an 
DCAM übergeben. Dieses Paßwort ersetzt das vom Benutzer angegebene 
RDF-Paßwort beim YOPEN oder das LOGON-Paßwort beim YOPNCON 
ACCEPT. 
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A.14.2.1.3 


Rückkehrinformation 


Die Exit-Routine gibt in Register 13 Rückkehrinformation an die rufende DCAM-Komponente 
in folgendem Format zurück: 


Register 15 Byte 0: reserviert 


RC: 


FDBK: 


Byte 1-2: FDBK 
Byte 3: RC 


Rückkehrinformation der Exit-Routine an die rufende DCAM-Komponente. Folgende 
Werte sind möglich: 


00: Aufruf annehmen 
04 : Aufruf ablehnen 
08 : Aufruf modifizieren 


Rückkehrinformation der Exit-Routine an den DCAM-Benutzer. Dieses Feld muß 
versorgt werden, wenn RC = 04 gesetzt ist. Diese Angabe wird an den DCAM-Benut- 
zer im Feld FDBK1/FDBK2 übergeben. FDBK kann entweder aus einem für die 
Exit-Routine reservierten Bereich ’'CC00’-"CCFF’ genommen werden oder kann einer 
der gültigen DCAM-Returncodes sein. FDBK darf nicht 70000” sein. 


Falls RC=08 angegeben ist, übergibt die Exit-Routine in der Parameterliste 
YDDEXPL die gültigen Daten für die Modifikation. 
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А.14.2.2 DCAM-Exit-Ereignisse 


A.14.2.2.1 DCAM Datenstruktur 


Im folgenden werden die wichtigsten Elemente der DCAM-Datenstruktur beschrieben: 


DARPPAR 


ACB 
CCB 
RPB 
ENB 
DIP 


DCG 
DACB 


DCCB 


DRPB 


A14 - 10 


interner DCAM Arbeitsbereich 


enthält prozeßspezifische Daten, z.B. die aktuellen Adressen der DCAM- 
Kontrollblöcke. 


Nicht angegebene Adressen/Felder sind mit Х'00' initialisiert. 


vom Benutzer angegebene Kontrollblöcke 


DCAM application control block 


Der DACB enthält anwendungsspezifische Daten, z.B. Anwendungsname, 
Attribute, .... Der DACB wird beim YOPEN angelegt und bleibt bis zum 
Schließen der Anwendung bestehen. 


DCAM connection control block 


Der DCCB enthält verbindungsspezifische Daten, z.B. Partner-, Prozessor- 
namen. Pro Verbindung wird ein DCCB angelegt. 


DCAM request parameter block 


enthält bei asynchronen Aufrufen die aufrufspezifischen Informationen aus 
dem RPB. 
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Beim Aufruf der Exit-Routine sind, abhängig vom Exit-Ereignis, folgende Felder der DCAM- 
Datenstruktur versorgt: 


Feldname | Feldinhalt Exit-Ereignis 


YDDEXPL: Exit Parameterliste 


YDDXMAIN | Exit Hauptereignis 

YDDXSUB Exit Unterereignis 

YDDXDPAR | A (DARPPAR) = interner Arbeitsbereich 
YDDXLOGL | Länge der Verbindungsnachricht 
YDDXLOGM | Adresse der Verbindungsnachricht 


YDDDVEC: interner Arbeitsbereich 


YDDVAEXV | A(XVT) 

YDDVATCB | A(TCB) 

YDDVADAC | A(DACB) DCAM application control block 
YDDVADCC | A(DCCB) DCAM connection control block 
YDDVADRP | A(DRPB) DCAM request control block 
YDDVARPB | А(ВРВ) user request control block 


Zur Versorgung der übrigen Felder des internen Arbeitsbereichs und der Kontrollblöcke 
(DACB, DCCB, ...) siehe A.14.2.4. Nicht versorgte Adressen und Felder sind mit X’00' 
initialisiert. 
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А.14.222 Rückinformation für die Exit-Ereignisse 


Bei den Exit-Ereignisse, die zur Information der Exit-Routine dienen, kann die Exit-Routine die 
Bearbeitung in DCAM nicht beeinflussen. Bei folgenden Exit-Ereignisse muß daher immer 
НС--00 im Register 15 zurückgegeben werden: 


APPCLS 
APPSHU 
APPTRM 
APPFCL 
CONCPL 
CONCLS 
CONFCL 
CONBAD. 


Bei den Exit-Ereignissen APPOPN, СОМАСО, CONACC und СОМВЕО kann die Exit-Routine die * 
weitere Bearbeitung in DCAM beeinflussen. Aus nachfolgender Tabelle ist zu sehen, welche 
Rückinformationen bei diesen Exit-Ereignissen gesetzt werden können. 


Rückinformation Bedingung | Exit-Ereignisse 


Register 
15 


YDDEXPL 


x: der Wert kann angegeben werden 

-: der Wert/das Feld kann nicht angegeben werden 

+: das Feld muß angegeben werden, falls die angegebene Bedingung zu- 
trifft. 


Durch Setzen des RC=08 in Register 15 kann die Exit-Routine die Modifikation einiger 
Benutzerangaben veranlassen. Die neuen Angaben werden über die Rückgabefelder in der 
Parameterliste YDDEXPL an DCAM übergeben. 


Folgende Modifikationen können veranlaßt werden: 


übergebenen Daten ersetzt 


CONACQ YDDXPW das LOGON-Paßwort (Parameter LOGPW im CCB) wird vor 
dem BCAM-Aufruf durch das übergebene Paßwort ersetzt 


Exit-Case Feld in Modifikation 
YDDEXPL 
APPOPN YDDXPW das RDF-Paßwort (Parameter USEPW im ACB) wird beim 
BCAM-Aufruf durch das übergebene Paßwort ersetzt 
CONACC YDDXLOGM | die Verbindungsnachricht (LOGON MESSAGE) des Benutzers 
CONACQ (Inhalt von AREA) wird vor dem BCAM-Aufruf durch die 
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А.14.2.3 Einschränkungen für DCAM-Exit-Routinen 


Für die Programmierung von DCAM-Exit-Routinen gelten die im Manual "В52000 System 
Exits’ beschriebenen Einschränkungen. Um Inkonsistenzen in der DCAM-Datenstruktur und 


Deadlocksituationen zu vermeiden, gelten für DCAM-Exit-Routinen zusätzlich folgende Ein- ` 


schränkungen. 


1) 


2) 
3) 
4) 


Auf alle Felder der DCAM Datenstruktur (DARPPAR, Kontrollblöcke) darf nur lesend 
zugegriffen werden. 
Schreibzugriff ist nur für die Rückgabefelder in der Parameterliste YDDEXPL erlaubt. 


Es sind keine BCAM-Aufrufe erlaubt. 
Die Exit-Routine darf keine Börsen-Locks setzen. 


Die Aufrufe $MASK und $UNMASK dürfen nicht verwendet werden. 
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А.14.2.4 DSECT-Makroaufrufe für die DCAM-Kontrollblöcke 


Für das Layout der DCAM-Kontrollblöcke wird keine Kompatibilität garantiert. Der Zugriff zur 
DCAM-Datenstruktur darf daher nur über die symbolischen Feldnamen erfolgen, bei DCM 
Versionswechsel können Neuübersetzungen notwendig werden. 


1. DCAM interner Arbeitsbereich (DARPPAR): 


Format: 
Name Operanden 
[symbol] | YDDDVEC D 
С 
prefix 
[, ] 
YDDV 


2. DCAM application control block (DACB) 


Format: 
Name Operation Operanden 
[symbol] | YDDDACB D 

С 


prefix 
deel 
YDDH 


3. DCAM connection control block (DCCB) 


Format: 
Name Operation Operanden 
[symbol] | YDDDCCB D 

С 


prefix 
1 N 
YDDL 
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4. DCAM request parameter block (ОВРВ) 


ç Format: 


Name Operanden 
[symbol] | YDDDRPB D 
С 


prefix 
Caen 
YDDD 


Erklärung der Operanden 
[symbol] symbolische Adresse für den Makroaufruf. Wird keine Adresse angegeben, | 


so wird als Adresse der Makroname angenommen. 


D gibt an, daß ein Pseudoabschnitt generiert werden soll. 
© | С gibt an, daß ein Abschnitt generiert werden soll. 
prefix Zeichenfolge von maximal 4 Zeichen, die dem Namen vorangestellt wird. 
Fehlt diese Angabe, so wird jeweils die unterstrichene Zeichenfolge voran- 
gestellt. 
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Stichwörter 


Querverweise sind durch Kursivdruck gekennzeichnet. 


AAREA-Operand im RPB 4-52 
- bei YINQUIRE 4-40 
- bei YRECEIVE 4-47 
- bei YPERMIT 4-46 
- bei YREJLOG 4-49 
- bei YSENDREC 4-65 
AAREALN-Operand im RPB 4-52 
- bei YINQUIRE 4-40 
- bei YRECEIVE 4-47 
- bei YSENDREC 4-65 
Abbau logischer Verbindungen 
Abfragen: YINQUIRE 
Abhängigkeit vom Format der Steuerblöcke 2-6 
ablaufinvariante Programmierung 
- allgemein 2-6 
- MF-Operand 2-7 
Absender einer Nachricht: Kommunikationspartner 
Absolute zusammengesetzte Ausdrücke А5-1 
ACB (application control block) 
- adressiert im RPB 4-53 
- Erzeugung: YACB, YGENCB 
- Inhalt: YOPEN 
- Verwendung: YSETLOG, YINQUIRE, 
YCLOSE, YOPNCON, YCLSCON, YREJLOG, 
YCHANGE, YSEND, YRECEIVE, 
YSENDREC, YPERMIT, YFORBID 
ACB-Operand: ACB 
ACB-Operandenwert: BLK-Operand 
ACCEPT-Operandenwert des OPTCD-Operanden 
- im RPB 4-55 
- bei YOPNCON 4-45 
ACQUIRE-Operandenwert des OPTCD-Operanden 
- im RPB 4-55 
- bei YOPNCON 4-45 
Adresse des Steuerblocks 2-4 
Adressierung des Steuerblocks 
Adreßverweise 2-5 
Ändern von Operandenlisten (Parameterlisten) 
- allgemein 2-8 
Ändern von Steuerblockfeldern 
- durch Aktionsaufrufe 2-15 
- durch YMODCB 2-16 
AID (application identifier) 
- Erzeugung: YOPEN 
- Verwendung: ACB 
AID-Operand: A/D 
Aktionsaufrufe: 
Makroaufrufe, YOPEN, YCLOSE, YSETLOG, 
YINQUIRE, YOPNCON, YREJLOG, 
YCLSCON, YCHANGE, YSEND, YRECEIVE, 
YSENDREC, YPERMIT, YFORBID 
Anfangsadresse 2-20 
Anforderungsparameterblock: RPB 
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Anstoß einer Contingency 
Anwendungsname 

- APPNAME-Operand 

- bei YINQUIRE 3-18 
Anwendungssteuerblock: ACB 
ANY-Operandenwert des OPTCD-Operanden 

- Hinweis 4-48 

- im RPB 4-58 

- bei YOPNCON 4-45 

- bei YRECEIVE 4-47 
ANYSTART-Operandenwert: PROC-Operand 
APPLICATION-Kommando А8-1 
APPNAME-Operand 

- im ACB 4-4 

- bei YOPEN 3-5ff 


APPSTAT-Operandenwert des OPTCD-Operanden 


- im RPB 4-58 

- bei YINQUIRE 4-40 
APPSTART-Operandenwert: PROC-Operand 
AREA-Operand 

- im RPB 4-53 

- bei YFORBID 4-35 

- bei YINQUIRE 4-39 

- bei YOPNCON 4-45 

- bei YPERMIT 4-46 

- bei YREJLOG 4-49 

- bei YSEND 4-63 

- bei YSENDREC 4-65 
AREALN-Operand 

- im АРВ 4-53. 

- bei YOPNCON 4-45 

- bei YSEND/YSENDREC 4-63Н 
asynchrone DCAM-Meldungen 

- allgemein 2-24 

- Datenübermittlungsfunktion 3-56 

- Existenzfunktion 3-3f 

- Festlegung: ENB-Operand 

- Registerbelegung АЗ-1# 

- Verbindungsfunktion 3-21 

- COMEND 2-28 

- EXPR 2-28 

- LOGON 2-26 

- LOSCON 2-27 

- PROCON 2-28 

- TACK 2-29 

- SECOND 2-29 
ASY-Operandenwert des OPTCD-Operanden 

- im RPB 4-60 

- bei YOPNCON 4-45 

- bei YRECEIVE/YSENDREC 4-47, 4-66 


ATTR-Operand 

- im ACB 4-6, A1-1 

- bei YOPEN 3-5ff 
Aufbau einer logischen Verbindung: Aufforderung 
Aufforderung zum Aufbau einer Verbindung 

- Annahme: YOPNCON (OPTCD=ACCEPT) 

- Ausgabe: YOPNCON (OPTCD = ACQUIRE) 

- Bearbeitung: 
LOGON-/NLOGON-Operandenwert des ATTR- 
Operanden 

- Rücknahme 3-49f 

- Rückweisung: YREJLOG 

Aufrufe: Makroaufrufe 
Ausführung eines Befehls 

- allgemein 2-11, 2-19 

- Aufhebung 3-19 

- asynchrone 2-20ff 

- Einstellen im RPB 4-52 

- Eintrag in Warteschlange: 
Q-/NQ-Operandenwert im OPTCD-Operanden 

- Registerbelegung A3-1f 

- Rückmeldung A2-1ff 

- synchrone 2-19 

- Wartezeit oder Lebensdauer: TOVAL-Operand 

Auswerten der Steuerblockfelder 2-1f 


Bedienplatz (Konsole) 2-28 
Befehl an DCAM: Ausführung eines Befehls 
Befehlsform (E-Form = Execute-Form) 2-8 
Beginn der Datenübermittlung 3-22, 4-22 
Begleitinformation (USERFLD) 

- Festlegung im CCB 3-22, 4-22 

- Übergabe in Contingency 2-28f 
Behandlung von Nachrichten 

- Datenübermittlungsprotokoll 3-24, 4-14 

- Groß-/Kleinschreibung 3-24, 4-16 

- Hardcopy 3-24, 4-17 

- Nachrichtenaufbereitung 

- zu lange Nachrichten 3-22, 3-57ff, 4-15f, 4-52 

- Rückwärtsschritt 3-24, 4-15 
Benutzerfeld: Begleitinformation 
Benutzerspeicher 2-20, 3-56 
Benutzung der Manuale 

- für Anfänger 1-2 

- für Geübte 1-3 
BINARY-Operandenwert: PROC-Operand 
Bitmuster: transparenter Modus 
BLK-Operand 

- im YGENCB 4-36 

- im ҮМООСВ 4-41 

- im YSHOWCB 4-68 

- im YTESTCB 4-71 
BLKADDR-Operand 

- im ҮМООСВ 4-41 

- im YSHOWCB 4-68 

- im YTESTCB 4-71 


CA-Operandenwert des OPTCD-Operanden 
- іт АРВ 4-55 
- bei YOPNCON 3-26, 4-45 
- bei YRECEIVE 3-57, 4-48 


- bei YSEND/YSENDREC 3-59, 4-63, 4-66 
CCB (connection control block) 
- Adressierung im RPB 4-54 
- Erzeugung mit YCCB, YGENCB 
- Inhalt 3-22ff 
- Verwendung bei YOPNCON, YCLSCON, 
YINQUIRE, YSEND, YRECEIVE, YSENDREC, 
YCHANGE | 
ССВ-Орегапа: ССВ ` 
CCB-Operandenwert: BLK-Operand 
CCBTK-Operandenwert des OPTCD-Operanden 
- Hinweis 3-22 
- im RPB 4-60 
- bei YRECEIVE/YSENDREC 3-61 
CID (connection identifier) 
- Erzeugung mit YOPNCON 
- Verwendung bei YINQUIRE, YCLSCON, 
YCHANGE, YSEND, YRECEIVE, YSENDREC 
CIDXLATE-Operandenwert des OPTCD-Operanden 
- im RPB 4-58 
- bei YINQUIRE 3-40, 4-40 
CLT (communication link table) 3-70ff, 4-10, 4-27 
Code der Nachricht 
- allgemein 3-22, 4-21 
CODELN-Operand 
- im DIP 4-31 
CODEPOS-Operand 
- im DIP 4-31 
CODEVAL-Operand 
- im DCG 4-30 
- bei YCHANGE 3-51 
- bei YPERMIT 3-67 
COID (contingency identifier) 
- Erzeugung mit ENACO 
- Verwendung 2-22ff 
COMEND-Meldung: asynchrone DCAM-Meldungen 
COMEND-Operand 
- im ENB 4-33 
- bei YOPEN 3-3ff 
CONNECTION-Kommando A8-2 
Contingency (-Routine) 
- bei asynchroner Befehlsausführung 2-22f 
- bei asynchroner DCAM-Meldung 2-24 
- Registerbelegung A3-2ff 
- Unterbrechung durch eine Contingency 4-48 
CONTXT-Makroaufruf 2-20f 


Daten (Verbleib bei Abbruch) 3-19 

- Ändern des Zustands: YSETLOG 

- Beschreiben: ACB 

- Eröffnen: YOPEN 

- Kennzeichen 

- Schließen: YCLOSE 

- symbolische Namen 

- Zustand: START-/STOP-Operandenwert 
DCAM-Meldung: asynchrone DCAM-Meldung 
DCG (distribution code group block) 

- Erzeugen: YGENCB/YDCG 

- Verteilcodes 

- Verteilcode-Verwendung 
DCG-Operand 
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- im DIP 4-31 

- bei YCHANGE 3-51 

- bei YOPNCON 3-34 
DCG-Operandenwert: BLK-Operand 
DCSTA-Makroaufruf A4-2ff 
DEPROT-Operand 

- im CCB 4-14 

- bei YOPNCON 3-24 
Dezimaler Integer А5-11 
DID (distribution identifier) 

- Erzeugen: YOPNCON 

- Verteilcode-Verwendung 
DIP (distribution parameter block) 

- Adressieren im CCB 

- Erzeugen: YDIP/YGENCB 

- Verteilcode-Verwendung 
DIP-Operand: DIP | 
DIP-Operandenwert: BLK-Operand 
DISCO-Operandenwert des ATTR-Operanden 

- im ACB 4-5 

- bei YOPEN 3-8 
DISNAME-Operand: Verteilungsname 
DUMMY-SECTION A7-1ff 


Eckige Klammer 4-1 
EDIT-Operand 

- im CCB 4-14 

- bei YOPNCON 3-22f 
EDITIN-Operand 

- im ССВ 4-15f 

- bei YOPNCON, YCHANGE 3-22f 
EDITOUT-Operand 

- im CCB 4-16f 

- bei YOPNCON, YCHANGE 3-22f 
E-Form des Makroaufrufs: Befehlsform 
EID (event item identifier) 

- Adressieren im RPB 4-54 

- asynchrone Ausführung eines Befehls 

- Erzeugen: ENAEI 
EID-Operand: Е/Р 
EIDREF-Operand: Ereignisinformation 
Einstellen von Warteschlangen 
Eintreffen eines Ereignisses 

- asynchrone Ausführung eines Befehls 

- asynchrone DCAM-Meldungen 
Eintreffen der Nachricht 2-19 
ELEMENT-Operandenwert des OPTCD-Operanden 

- im RPB 4-56 

- bei YSEND/YSENDREIC 3-56f, 4-63, 4-66 
Empfangen einer Nachricht 

- Verwendung von Kennzeichen 2-12 

- YRECEIVE 

- YSENDREC 
ENACO-Makroaufruf 2-20f 
ENAI-Makroaufruf 2-20f 
ENB (event notification block) 

- Adressieren im ACB 4-7 

- Erzeugen: YENB/YGENCB 

- Verwenden: YOPEN 


DCAM V8.0A DCAM Makroaufrufe, 0987-.)-2775-2 


ENB-Operand 
- im ACB 4-7 
- bei YOPEN 3-4ff 
ENB-Operandenwert: BLK-Operand 
Ereignis 
- asynchrone Ausführung eines Befehls 
- asynchrone DCAM-Meldungen 
Ereignisinformation 
- allgemein 2-23 
- im RPB 4-54 
- bei YOPNCON 3-26f, 4-44 
- bei YRECEIVE/YSENDREC 3-61, 4-48, 4-65 
- bei YRECEIVE/YSENDREC 3-60, 4-47, 4-65 
- bei YRECEIVE/YSENDREC 3-60, 4-47, 4-65 
Ereigniskennzeichen: EID 
Ereignis-Meldungsblock: ENB 
ERET-Operand 4-71 
Eröffnen (Erzeugen) einer DCAM-Anwendung: 
YOPEN 
erstmaliges Eröffnen: Primärprozeß 
Erzeugen von Steuerblöcken | 
- allgemein 2-3ff 
- direkt 
- dynamisch: YGENCB 
- statisch: YACB/YCCB/YDCG/YDIP/YENB/YRPB 
explizite Adresse Ab-1ff 
Expreßnachricht 
- Empfangen mit asynchroner Meldung 2-28ff 
- Senden: EXPRESS-Operandenwert 
EXPR-Operand 
- im ENB 4-33 
- bei YOPEN 3-4ff 
EXPRESS-Operandenwert des OPTCD-Operanden 
- im RPB 4-56 
- bei YSEND/YSENDREC 4-63, 4-66 
EXPR-Meldung: asynchrone DCAM-Meldung 


Fehler 
- Auftreten bei Ausführung eines Aufrufs 2-22 
- Maßnahme bei YTESTCB: ERET-Operand 
Feldnamen A7-1ff 
FIELDS-Operand 4-69 
FLAG-Feld 2-11, 2-16 
FORM-Operandenwert 
- EDITIN-Operand 
- EDITOUT-Operand 


Geschweifte Klammer 4-1 
GETBS-Operandenwert: ED/TIN-Operand 
GETFC-Operandenwert: EDI/TIN-Operand 
GID (code group identifier) 

- Erzeugen: YOPNCON/YCHANGE/YPERMIT 

- Verwendung von Verteilcodes 
Groß-/Kleinschreibung: Behandlung von Nachrichten 


GROUP-Operandenwert des OPTCD-Operanden 


- im RPB 4-56 
- bei YSEND/YSENDREC 4-63, 4-66 


Hardcopy: Behandlung von Nachrichten 
Hauptroutine 2-25 
HCOPY-Operandenwert: EDITOUT-Operand 


Information 

- Abfragen: YINQUIRE 

- Begleitinformation 

- Ereignisinformation 

- Partnerinformation 

- Rückinformation 
Informationsfeld 3-9, 3-42ff, A4-1f 


KEEP-Operandenwert des OPTCD-Operanden 

- im RPB 4-60 

- bei YRECEIVE/YSENDREC 4-48, 4-66 
KEEP-Operandenwert des PROC-Operanden 

- im CCB 4-20 

- bei YOPNCON/YCHANGE 3-22 
Kennworte 

- zum Anschluß des Sekundärprozesses: 

USEPASS-/USEPW-Operand 
- RDF-Kennwort 
- zum Verbindungsaufbau: 
LOGPASS-/LOGPW-Operand 

Kennzeichen 

- allgemein 2-11 

- sicherstellen 2-17 

- Verwendung 2-12ff 

- Ereigniskennzeichen: EID 

- Contingency-Kennzeichen: СО/О 

- der DCAM-Anwendung: A/D 

- der logischen Verbindung: С/О 

- der LOGON-Meldung: LID 

- der Verteilungsparameter: DID 

- der Verteilcode-Gruppe: GID 
Kettungsname: LINK-Operand 
Klasse-5-Speicher 2-6f, 4-36 
Kommandos 

- /APPLICATION 3-71 

- /BCIN 2-28 

- /СОММЕСТІОМ 3-73 

- /SHUTDOWN 2-28 
(Kommunikations-)Partner 

- beliebiger: ANY-Operand 

- bestimmter: SPEC-Operand 

- vordefinierter 2-28 
Kompatibilität 
Konsole: Bedienungsplatz 


Länge 

- Datenfelder 4-52f 

- Nachricht 

- Steuerblockfelder 2-17 

- Steuerblöcke 4-36f 

- Verbindungsnachricht 
Laufnummer der Nachricht 
Laufzeit 2-15 


- 


LCASE-Operandenwert: EDITIN-Operand 
Lebensdauer eines Befehls: TOVAL-Operand 
LENGTH-Operand 

- im YGENCB 4-36 

- im YSHOWCB 4-69 
LEVCO-Makroaufruf 2-24 
LID (logon identifier) 

- erzeugt bei LOGON-Meldung 2-26, A3-2 

- Verwendung 3-40 
LINE-Operandenwert 

- EDITIN-Operand 

- EDITOUT-Operand 
LINK-Operand 

- im ACB 4-7, A1-1 

- im CCB 4-19, A1-2 

- im APPL 4-10 

- in der CLT: YAPPL/YCONN 

- Verwendung 3-72, 3-73 
LINKMOD-Operand 

- im ACB 4-7 

- im CCB 4-19 

- bei YOPEN 3-4ff 

- bei YOPNCON 3-24 
Listenform (L-Form) 2-8Н 
Logische Datenstation: Nachrichtenaufbereitung 
logische Verbindung 

- Abbau 3-55 

- Abbruch (Verlust) 2-27, 3-19 

- Aufbau 2-26, 3-21ff 

- Begleitinformation 

- Kennworte 

- Kennzeichen 
LOGON-Meldung: asynchrone DCAM-Meldungen 
LOGON-Operand 

- im ENB 4-33 

- bei YOPEN 3-4ff 
LOGON-Operandenwert des ATTR-Operanden 

- im ACB 4-6, A1-1 

- bei YOPEN 3-4ff 
LOGPASS-Operand 

- im ACB 4-8, A1-1 

- bei YAPPL 3-74, 4-12 

- bei YOPEN 3-4Н 
LOGPW-Operand 

- im CCB 4-19, A1-2 

- bei YCONN 3-73, 4-29 

- bei YOPNCON 3-26 
LOSCON-Meldung: asynchrone DCAM-Meldungen 
LOSCON-Operand 

- im ENB 4-33 

- bei YOPEN 3-4ff 


Makroaufrufe an DCAM 
- Aktionsaufrufe 2-1f, 3-1 
- allgemein 2-1, 4-2f 
- Beendigung 2-11 
- Datenübermittlungsfunktion 3-56ff 
- Existenzfunktion 3-3ff 
- Form 2-7f 
- Lebensdauer: TOVAL-Operand 
- Namen-Zuweisungsfunktion 3-70ff 
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- Registerbelegung A3-1f 

- Verbindungsfunktion 3-20ff 

- Wiederholung 2-19 

- f... 
Makrogenerator 2-4 
Meldungen: asynchrone DCAM-Meldungen 
MF-Operand 

- allgemein 2-8ff 

- YGENCB 4-37 

- YMODCB 4-41 

- YSHOWCB 4-69 

- YTESTCB 4-71 
membotechnische Werte 4-1, А5-1# 


Nachfolgendes Eröffnen: Sekundärprozeß 
Nachricht 

- Behandlung 

- Empfangslänge 3-58, 3-61 

- Laufnummer 

- Priorität 

- Sendelänge 3-57, 3-63 

- Strukturierung 3-57 
Nachrichtenaufbereitung 

- allgemein 2-28, 3-22ff, 4-15ff 

- beim Empfangen 3-22ff, 4-15f 

- beim Senden 3-22ff, 4-16f 
Nachrichtenverteilung 

- absenderspezifisch: CS-/SPEC-Operandenwert 

- empfängerglobal: CA-/ANY-Operandenwert 

- verteilcodespezifisch: Verteilcode-Verwendung 
Name: symbolischer Name 
Namen-Zuweisung 

- Kommandos А8-11 

- YAPPL 

- YCONN 
NAMXLATE-Operandenwert des OPTCD-Operanden 

- im RPB 4-57 

- bei YINQUIRE 3-47, 4-40 
NDISCO-Operandenwert des ATTR-Operanden 

- im ACB 4-5, A1-1 

- bei YOPEN 3-4, 3-6 
negative Quittung: Transportquittung 
NGETBS-Operandenwert: EDITIN-Operand 
NGETFC-Operandenwert: EDITIN-Operand 
NHCOPY-Operandenwert: EDITOUT-Operand 
NHOM-Operandenwert: EDITOUT-Operand 


` NLCASE-Operandenwert: EDITIN-Operand 


NLOGON-Operandenwert des ATTR-Operanden 
- im ACB 4-6, А1-1 
- bei YOPEN 3-4ff 
NO-Operandenwert: VERIFY-Operand 
NORMAL-Operandenwert des OPTCD-Operanden 
- im RPB 4-56 
- bei YSEND/YSENDREC 3-57, 4-63, 4-66 
NOTACK-Operandenwert des ATTR-Operanden 
- im ACB 4-6, А1-1 
- bei YOPEN 3-6ff 
МО-Орегапдепугегі des OPTCD-Operanden 
- allgemein 2-19 
- im RPB 4-57 
- bei YOPNCON 3-30, 4-45 
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- bei YRECEIVE/YSENDREC 3-61, 4-47, 4-66 
NSHARE-Operandenwert des ATTR-Operanden 
- іт ACB 4-5, А1-1 
- bei YOPEN 3-4 
NTACK-Operandenwert des OPTCD-Operanden 
- im RPB 4-59 
- bei YSEND/YSENDREC 3-57, 4-63, 4-66 


Operanden-Unterliste 4-1 
Operator (Operateur) 2-27 
OPTCD-Operand 
- im RPB 4-55ff 
- bei YINQUIRE 3-17, 3-40Н, 4-40 
- bei YOPNCON 3-26ff 
- bei YRECEIVE 3-59, 4-47f 
- bei YSEND/YSENDREC 3-57f, 3-65f, 4-66 
- bei YSETLOG 3-15, 4-67 ` 


Parameterliste (Operandenliste) 2-7f 
Partner: Kommunikationspartner 
Partneranzahl: COUNTPTN-Operandenwert 
Partnercharakteristika 

- Abfragen: YINQUIRE 

- PTNCHAR-Operandenwert 

- Tabelle А4-1Н 
Partnerinformation: YINQUIRE 
Partnername: PTNNAME-Operand 
PHYS-Operandenwert 

- EDITIN-Operand 

- EDITOUT-Operand 
positive Quittung: Transportquittung 
Primärprozeß 

- Empfang von Expressnachrichten 

- Empfang von Transportquittungen 

- Eröffnen einer DCAM-Anwendung 3-3ff 

- Schließen einer DCAM-Anwendung 3-19 

- Steuerung der Verteilcode-Zuordnung 3-67 

- Verbindungsaufbau: YOPNCON 

- Vorgabe der Kennworte 
PRIMARY-Operandenwert des VERIFY-Operanden 

- im ACB 4-9, A1-1 

- bei YOPEN 3-6f, 3-8f 
PRIMTASK-Operandenwert des ATTR-Operanden 

- im ACB 4-6, A1-1 

- bei YOPEN 3-6ff 
Priorität 

- der Contingency 2-20, 2-24 

- der Nachricht 3-56, 4-56 
PROCON-Meldung: asynchrone DCAM-Meldungen 
PROC-Operand 

- im CCB 4-22ff, A1-2 

- bei YOPNCON/YCHANGE 3-22f 
PROCON-Operand 

- im ENB 4-34 

- bei YOPEN 3-4ff 
Programmablauf 2-1 
PRONAME-Operand 

- im CCB 4-14, A1-2 

- bei YCLSCON 3-b2f 

- bei YOPNCON 3-21f 
Prozessorname: PRONAME-Operand 


PTNCHAR-Operandenwert des OPTCD-Operanden 
- im RPB 4-58 
- bei YINQUIRE 3-40, 4-40 

PTNNAME-Operand 
- im CCB 4-13, A1-2 
- bei YCLSCON 3-54 
- bei YOPNCON 3-22f 

Punkte, drei 4-1 

P1 Eventing + Contingencies 2-20 


Q-Operandenwert des OPTCD-Operanden 
- allgemein 2-19 
- im RPB 4-57 
- bei YOPNCON 3-30, 4-45 
- YRECEIVE/YSENDREC 3-61, 4-47, 4-66 
Quittung: Transportquittung 


RDF-Kennwort 
Register 
- Adresse der Parameter-(Operanden-)Liste 2-6f 
- Beispiel für Verwendung 2-9 
- Kennzeichen: А/О 
- Kennzeichen: LID 
- Kennzeichen: CID 
- Länge der Verbindungsnachricht 3-40 
- Rückmeldung А2-1Н, A7-1ff 
- Steuerblockadresse 2-4, 2-15 
- Verweisadresse 2-6 
Registerbelegung A3-1ff 
relative zusammengesetzte Ausdrücke A5-1ff 
RPB(request parameter block) 
- Erzeugen: YRPB/YGENCB 
- Verwenden: Aktionsaufrufe 
RPB-Operand: RPB 
RPB=Operandenwert: BLK-Operand 
ВЕОТА5К-Орегапдепугегі des ATTR-Operanden 
- im ACB 4-6, А1-1 
- bei YOPEN 3-6ff 
REQLOGON-Operandenwert des OPTCD-Operanden 
- іт АРВ 4-57. 
- bei YINQUIRE 3-42, 4-40 
Rückinformation 
- allgemein 2-1f 
- Rückmeldung 2-11, А2-1Н, А7-1# 
Rückwärtsschritt: Behandlung von Nachrichten 
runde Klammer 4-1 


Schließen einer DCAM-Anwendung 3-19 
Schlüsselwort(-Operand) 2-4, 2-17, 4-1 
SECONDARY-Operandenwert des VERIFY-Operan- 
den 
- im ACB 4-9, A1-1 
- bei YOPEN 3-10ff 
SECOND-Meldung 
Sekundärprozeß 
- Empfang von Expreßnachrichten 2-28 
- Empfang von Nachrichten: YRECEIVE 
- Empfang von Transportquittungen 2-29 
- Eröffnen einer Anwendung 3-10ff 
- Kennworte 
- Schließen einer Anwendung 3-19 


- Senden von Nachrichten: YSEND 
selbstdefinierende Werte 2-4 
Senden einer Nachricht: YSEND 
senkrechter Strich 4-1 
SEQNO-Operand 

- im RPB 4-61 

- bei YSEND/YSENDREC 4-63, 4-66 
SHARE-Operandenwert des ATTR-Operanden 

- im ACB 4-5, A1-1 

- bei YOPEN 3-7ff 
SOLSIG-Makroaufruf 

- asynchrone Ausführung 2-22 

- synchrone Ausführung 2-20f 
SPEC-Operandenwert des OPTCD-Operanden 

- im RPB 4-58 

- bei YOPNCON 3-30ff 

- bei YRECEIVE 3-63, 4-47 
Speicherbereiche 

- Datenfelder 4-52ff 

- im Klasse-5-Speicher 

- für Steuerblöcke 4-36 

- für Steuerblock-Feldinhalte 4-69 
START-Operandenwert des OPTCD-Operanden 

- im RPB 4-58 

- bei YSETLOG 3-15, 4-67 
Steuerblockfelder 

- Ändern der Inhalte 2-15ff 

- Auswerten 2-1f, 3-1 

- Inhalte 2-1f 

- Lesen: YSHOWCB 

- Speicherbereiche für Feldinhalte 

- Standardwerte 2-4, 2-15, 3-1, 4-1 

- Testen: YTESTCB 
Steuerblöcke 

- Adresse 

- Adressierung 2-13 

- allgemein 2-1ff 

- Anforderungsparameterblock: RPB 

- Anwendungssteuerblock: ACB 

- Ereignis-Meldungsblock: ENB 

- Erzeugung von Steuerblöcken 

- Verbindungssteuerblock: CCB 

- Verteilcode-Gruppenblock: DCG 

- Verteilungsparameter-Block: DIP 

- Verwendung 2-11 
Steuerung 

- von Prozessen 2-19f 

- der Verteilcode-Zuordnung: 

YPERMIT/YFORBID 

STOP-Operandenwert des OPTCD-Operanden 

-im RPB 4-58 

- bei YSETLOG 3-15, 4-67 
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SUBGROUP-Operandenwert des OPTCD-Operanden 
- im RPB 4-56 
- bei YSEND/YSENDREC 3-57f, 4-63, 4-66 
SVC (supervisor call) 2-8 
symbolischer Name 
- DCAM-Anwendung: 
APPNAME-Operand/Anwendungsname 
- Partnername: 
PTNNAME-Operand/ 
asynchrone-DCAM Meldungen 
(PROCON)/NAMXLATE-/ 
CIDXLATE-Operandenwert 
- Prozessorname: 
PRONAME-Operand/ 
asynchrone DCAM-Meldungen 
(PROCON)/NAMLATE-/ 
CIDXLATE-Operandenwert 
- Verteilungsname 
synchrone Ausführung eines Befehls 2-19 
SYN-Operandenwert des OPTCD-Operanden 
- im RPB 4-59 
- bei YOPNCON 3-26, 3-30, 4-45 
- bei YRECEIVE/YSENDREC 3-61, 4-47, 4-66 
SYSCODE-Operandenwert: PROC-Operand 
SYSTEM-Operandenwert: ЕП/Т-Орегапа 


TACK-Meldung: asynchrone DCAM-Meldung 


` TACK-Meldung 


- im ENB 4-34 

- bei YOPEN 3-4ff 
TACK-Operandenwert des OPTCD-Operanden 

- im RPB 4-59 

- bei YSEND/YSENDREIC 3-56, 4-63, 4-66 
Teilnachricht 4-56f 
Testen von Steuerblockfeldern: YTESTCB 
Text А5-1 
TOPLOGON-Operandenwert des OPTCD-Operanden 

- im RPB 4-57 

- bei YINQUIRE 3-42f, 4-40 
TOVAL-Operand 

- im RPB 4-61 

- bei YOPNCON 3-30, 4-45 

- bei YRECEIVE/YSENDREC 3-61, 4-48, 4-66 
transparenter Modus (Bitmuster) 3-22, 4-21 
Transportquittung 

- Anfordern: TACK-Operandenwert 

- Einstellen im RPB 4-6 

- Empfangen: 

asynchrone Meldung/YRECEIVE/YSENDREC 
- Identifizieren durch Laufnummer: 
SEQNO-Operand 

- Verteilung 3-6f, 3-8f 
TRUNC-Operandenwert des OPTCD-Operanden 

- im RPB 4-60 

- bei YRECEIVE/YSENDREC 3-61, 4-48, 4-66 
TRUNC-Operandenwert des PROC-Operanden 

- im CCB 4-20 

- bei YOPNCON/YCHANGE 3-22 


Unterbrechnung 2-24 
Unterbrechungsroutine: Contingency 
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unterstrichener Operand 4-1 
USEPASS-Operand 

- im ACB 4-9, A1-1 

- bei YAPPL 3-70, 4-11 

- bei YOPEN 3-6f, 3-8f 
USEPW-Operand 

- im ACB 4-9, A1-1 

- bei YAPPL 3-70, 4-11 

- bei YOPEN 3-10f, 3-12f 
USERFLD-Operand: Begleitinformation 
USER-Operandenwert: ЕП/Т-Орегапа 


Verändern: YSETLOG/YCHANGE 
Verarbeitungsrechner 4-4 
Verbindungsabbruch 2-27, 3-19 
Verbindungsaufbau: Aufforderung zum V. 
Verbindungsnachricht 

- Länge 2-26, 3-40f 

- Speicherbereich 3-26f 
Verbindungssteuerblock: CCB 
VERIFY-Operand 

- im ACB 4-9, A1-1 

- bei YOPEN 3-6Н 
Verteilcode 

- Beschreiben 3-24, 4-30 

- Länge 3-25, 4-30 

- Position in der Nachricht 3-25, 4-30 
Verteilcode-Gruppenblock:DCG 
Verteilcode-Verwendung 

- Aufbau der Verbindung 3-34f 

- Empfang von Expreßnachrichten 2-28 

- Eröffnen der DCAM-Anwendung 3-8f, 3-12 

- Steuerung der Zuordnung 3-67, 4-35, 4-46 
Verteilungsname 

- Angabe im Primärprozeß 3-81 

- Angabe im Sekundärprozeß 3-12 

- Eintrag in die CLT 3-70, 4-11 

- YFORBID 

- YPERMIT 
Verteilungs-Parameterblock: DIP 
Verweisadressen 2-6 
Vordefinierte Verbindung 3-38 
VTCSET A13-1ff 


WAREA-Operand 

- YGENCB 4-37 

- YSHOWCB 4-69 
Warteschlange 

- allgemein 2-19 

- Ausführung eines Befehls 

- CA-/CS-Operandenwert 

- Nachrichtenverteilung 

- Verteilcode-Verwendung 
Wartezeiten 

- abgelaufen 2-20 

- allgemein 2-19 

- maximal 2-19 

- bei SOLSIG 2-20f 

- bei YOPNCON 3-30 

- bei YRECEIVE 3-61 


- TOVAL-Operand 


Wiederholung eines Aufrufs 2-21 


XSTAT-Makroaufruf 2-28 


YACB 2-5, 4-4 
YAPPL 3-71, 4-10 
YCCB 2-4, 4-13 
YCHANGE 3-51f, 4-24 
YCLOSE 3-19, 4-25 
YCLSCON 3-53ff, 4-26 
YCONN 3-73f, 4-27 
YDCG 2-4, 4-30 
YDDACB A7-1ff 
YDDCCB А7-6Н 
YDDDCG А7-9Н 
YDDDIP A7-11ff 
YDDENB A7-13ff 
YDDFDB A7-21ff 
YDDRPB A7-15ff 
YDIP 2-1, 4-31 
YENB 2-4, 4-33 
YFORBID 3-70, 4-33 
YGENCB 2-6Н, 4-36 
YINQUIRE 

- allgemein 4-39 


- Kennzeichen der Verbindung 3-47 
- nach LOGON-Meldung 3-40 


- Partneranzahl 3-45 


- Partnercharakteristika 3-44 

- Partner- und Prozessorname 3-47 

- vor dem Verbindungsaufbau 3-42f 

- Zustand einer DCAM-Anwendung 3-17f 


ҮМОРСВ 2-16, 4-41 
ҮОРЕМ 
- allgemein 3-3, 4-43 


- einfach benutzbare Anwendung 3-4f 
- Erzeugen von Kennzeichen 2-12f 


- Festlegen von Meldungen 2-23 
- mehrfach benutzbare Anwendung 3-6ff 
YOPNCON 
- allgemein 3-21f, 4-44 
- Annahme einer Aufforderung 3-30ff 
- Ausgabe einer Aufforderung 3-26ff 
- asynchrone Ausführung 2-20ff 
- nach LOGON-Meldung 2-26 
- Verwendung von Kennzeichen 2-12f 
YPERMIT 3-67f, 4-46 
YRECEIVE 
- allgemein 4-47 
- asynchrone Ausführung 2-20ff 
- Funktion 3-59ff 
- Verwendung von Kennzeichen 2-13ff 
YREJLOG | 
- allgemein 4-49 
- Funktion 3-49f 
- nach LOGON-Meldung 2-26 
YRPB 2-4, 4-51 
YSEND 3-57ff, 4-62 
YSENDREC 
- allgemein 4-65 
- asynchrone Ausführung 2-20ff 
- Funktion 3-63f 
YSETLOG 3-15f, 4-67 
YSHOWCB 2-17, 4-68 
YTESTCB 2-18f, 4-71 


Zeichen А5-1Н 

Zeitangabe 2-20 

zu lange Nachricht: Behandlung von Nachrichten 

Zurücknahme einer Verbindungsaufforderung: 
YCLSCON 

Zurückweisen einer Verbindungsaufforderung: 
YREJLOG 

Zustand der DCAM-Anwendung: YSETLOG 
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